<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/downcase.c">
<Name>LQU_DownCase</Name>
<Class>Utilities/Strings
<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.
<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.
<Bugs>
The argument is not checked to see if it is a NULL pointer.
</Function>
<Decl>
API char *
LQU_DownCase(String)
    CONST char *String;
</Decl>
</Entry>
