char-lessp

Type:	-	predicate function (subr)
Source:	-	xlstr.c

Syntax

(char-lessp char1 charN ... )

char1 - a character expression
charN - character expression(s) to compare
returns -  T  if the characters are of monotonically increasing ASCII value, NIL otherwise
Note: case is not significant with this function

Description

The 'char-lessp' function takes one or more character arguments. It checks to see if all the character arguments are monotonically increasing.  T  is returned if the arguments are of increasing ASCII value. In the case of two arguments, this has the effect of testing if 'char1' is less than 'char2'. This test is case insensitive, the character '#\a' is considered to be the same ASCII value as '#\A'.

Examples

(char-lessp #\a #\b)      ; returns T
(char-lessp #\b #\a)      ; returns NIL
(char-lessp #\a #\b #\c)  ; returns T
(char-lessp #\a #\a)      ; returns NIL
(char-lessp #\a #\b #\b)  ; returns NIL
(char-lessp #\A #\a)      ; returns NIL
(char-lessp #\a #\A)      ; returns NIL

See the char-lessp predicate function in the XLISP 2.0 manual.

  Back to Top