MAINSAIL Language Manual, Section 32.89

previous   next   top   contents   index   framed top   this page unframed

32.89. cvl

Figure 32–93. cvl (GENERIC)
$BUILTIN
INTEGER
PROCEDURE   cvl         (INTEGER char);

COMPILETIME
STRING
PROCEDURE   cvl         (STRING s;
                         OPTIONAL POINTER($area) area);

cvl converts a character or STRING to lower case.

The STRING form converts a STRING to all lower case (i.e., the uppercase letters A through Z are converted to the corresponding lowercase letters a through z, and other characters are unchanged).

If char is the code of an uppercase letter, then the INTEGER form returns the code of the corresponding lowercase letter. Otherwise, cvl(char) is equal to char.

area specifies the destination area for the resulting STRING if new STRING text is generated; see Section 29.4.

Example 32–94. Use of cvl
cvl("ABc") = "abc"
cvl("A2$") = "a2$"

cvl('M')   = 'm'
cvl('n')   = 'n'

previous   next   top   contents   index   framed top   this page unframed

MAINSAIL Language Manual, Section 32.89