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

char-equal


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

Syntax

(char-equal char1 charN ... )
char1 - a character expression
charN - character expression[s] to compare
returns -  T  if all characters are equal, NIL otherwise
Note: case is not significant with this function

Description

The 'char-equal' function tests if all the character arguments are equivalent.  T  is returned if the arguments are of the same ASCII value, NIL otherwise. In the case of two arguments, this has the effect of testing if 'char1' is equal to 'char2'. This test is case insensitive, the character '#\a' is considered to be the same ASCII value as the character '#\A'.

Examples

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

See also:

  Back to Top


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