Converts a character string or a single character to lowercase. If the operand is a character string, the function converts the characters in place.
LPSTR CharLowerA( LPSTR lpsz );
A null-terminated string, or specifies a single character. If the high-order word of this parameter is zero, the low-order word must contain a single character to be converted.
If the operand is a character string, the function returns a pointer to the converted string. Because the string is converted in place, the return value is equal to lpsz.
If the operand is a single character, the return value is a 32-bit value whose high-order word is zero, and low-order word contains the converted character.
There is no indication of success or failure. Failure is rare. There is no extended error information for this function; do not call GetLastError.
Note that CharLower always maps uppercase I to lowercase I ("i"), even when the current language is Turkish or Azerbaijani. If you need a function that is linguistically sensitive in this respect, call LCMapString.
Conversion to Unicode in the ANSI version of the function is done with the system default locale in all cases.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||winuser.h (include Windows.h)|