Converts a character string or a single character to uppercase. If the operand is a character string, the function converts the characters in place.
LPSTR CharUpperA( LPSTR lpsz );
A null-terminated string, or 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 CharUpper always maps lowercase I ("i") to uppercase 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)|