lq-text: LQU_DownCase

API char * LQU_DownCase (String) CONST char *String;

Purpose

Returns a pointer to a static buffer containing a copy of the given string in which all upper-case characters have been converted to lower case. The buffer grows automatically, and requires that the given String be nul-terminated.

Bugs

The argument is not checked to see if it is a NULL pointer.

Notes

Relies on correct support from isupper, as described in ctype(3). On some systems, this function returns garbage if a character with the top bit set is tested, and LOCALE has not been set.