REF STRINGS Titch Le Bek, Rob Duncan, 1986 COPYRIGHT University of Sussex 1993. All Rights Reserved. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> <<<<<<<<<<<<<<<<<<<<< >>>>>>>>>>>>>>>>>>>>>> <<<<<<<<<<<<<<<<<<<<< LISP STRING PROCEDURES >>>>>>>>>>>>>>>>>>>>>> <<<<<<<<<<<<<<<<<<<<< >>>>>>>>>>>>>>>>>>>>>> <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< This file briefly describes the functions, variables and constants documented in Chapter 18 of the standard Common Lisp guide, which is: Common Lisp: The Language (Guy L. Steele, Digital Press, 1984). ------------------------------------------------- 1 A Listing of Functions Variables and Constants ------------------------------------------------- (char string index) [function] char returns the character at position index in string. (make-string number &key :initial-element) [function] Returns a string of length number whose elements are initialised to :initial-element. (nstring-capitalize string &key :start :end) [function] Destructively modifies the argument string such that the first character of every word is a capital letter. (nstring-downcase string &key :start :end) [function] Destructively modifies the argument string such that all upper case letters are converted to lower case. (nstring-upcase string &key :start :end) [function] Destructively modifies the argument string such that all lower case letters are converted to upper case. (schar string index) [function] Returns the character at position index of the simple string string. (string x) [function] If x is a string, it is returned. If x is a symbol, its print name is returned. If x is a string character then a string containing that one character is returned. If x is anything else, an error is signaled. (string-capitalize string &key :start :end) [function] Returns a copy of string with the first character in every word delimited by :start and :end capitalised. (string-downcase string &key :start :end) [function] Returns a copy of string in lower-case characters. (string-equal string1 string2 [function] &key :start1 :end1 :start2 :end2) Returns nil or the length of the longest common prefix of string1 and string2 each delimited by :start1 :end1 and :start2 :end2 respectively. Does not distinguish upper and lowercase characters. (string-greaterp string1 string2 [function] &key :start1 :end1 :start2 :end2) Compares string1 and string2 lexicographically. The result is nil unless string1 is greater than string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Does not distinguish upper and lowercase characters. (string-left-trim characters string) [function] Returns a substring of string with all characters in characters stripped off at the beginning. (string-lessp string1 string2 [function] &key :start1 :end1 :start2 :end2) Compares string1 and string2 lexicographically. The result is nil unless string1 is less than string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Does not distinguish upper and lowercase characters. (string-not-equal string1 string2 [function] &key :start1 :end1 :start2 :end2) Compares string1 and string2 lexicographically. The result is nil unless string1 is not equal to string2 The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Does not distinguish upper and lowercase characters. (string-not-greaterp string1 string2 [function] &key :start1 :end1 :start2 :end2) Compares string1 and string2 lexicographically. The result is nil unless string1 is not greater than string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Does not distinguish upper and lowercase characters. (string-not-lessp string1 string2 [function] &key :start1 :end1 :start2 :end2) Compares string1 and string2 lexicographically. The result is nil unless string1 is not less than string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Does not distinguish upper and lowercase characters. (string-right-trim characters string) [function] Returns a substring of string with all the characters in characters stripped off the end. (string-trim characters string) [function] Returns a substring of string with all the characters in characters stripped off the beginning and end. (string-upcase string &key :start :end) [function] Returns string delimited by :start and :end with all characters in uppercase. (string/= string1 string2 &key :start1 :end1 :start2 :end2) [function] Compares string1 and string2 lexicographically. The result is nil unless string1 is not equal than string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Distinguishes between upper and lower case letters. (string< string1 string2 &key :start1 :end1 :start2 :end2) [function] Compares string1 and string2 lexicographically. The result is nil unless string1 is less than string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments Distinguishes between upper and lower case letters. (string<= string1 string2 &key :start1 :end1 :start2 :end2) [function] Compares string1 and string2 lexicographically. The result is nil unless string1 is less than or equal to string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Distinguishes between upper and lower case letters. (string= string1 string2 &key :start1 :end1 :start2 :end2) [function] Compares string1 and string2 lexicographically. The result is nil unless string1 is equal to string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Distinguishes between upper and lower case letters. (string> string1 string2 &key :start1 :end1 :start2 :end2) [function] Compares string1 and string2 lexicographically. The result is nil unless string1 is greater than string2 The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Distinguishes between upper and lower case letters. (string>= string1 string2 &key :start1 :end1 :start2 :end2) [function] Compares string1 and string2 lexicographically. The result is nil unless string1 is greater than or equal to string2. The result is the length of the longest common prefix of the strings. The index returned in the case of a mismatch is an index into string1. The strings to be matched are delimited by the :start and :end arguments. Distinguishes between upper and lower case letters. --- C.all/lisp/ref/strings --- Copyright University of Sussex 1993. All rights reserved.