Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference

char<=

Type: - function (subr)

Source: - xlstr.c

Syntax

(char<= char1 charN ... ): char1 - a character expression
charN - character expression[s] to compare
returns - T if the characters are of monotonically non-decreasing ASCII value, NIL otherwise
Note: case is significant with this function

Description

The 'char<=' function tests if all character arguments are monotonically non-decreasing. T is returned if the arguments are of monotonically non-decreasing ASCII value, NIL otherwise. In the case of two arguments, this has the effect of testing if 'char1' is less than or equal to 'char2'. This test is case sensitive, the character '#\a' is different and of greater ASCII value than the character '#\A'.

Examples

(char<= #\a #\b)      => T
(char<= #\b #\a)      => NIL
(char<= #\a #\b #\c)  => T
(char<= #\a #\a)      => T
(char<= #\a #\b #\b)  => T
(char<= #\A #\a)      => T
(char<= #\a #\A)      => NIL