CharUpper
The CharUpper
function converts a character string or a single character to uppercase. If the
operand is a character string, the function converts the characters in place.
This function supersedes the AnsiUpper function.
LPTSTR CharUpper(
|
LPTSTR lpsz |
// single character
or pointer to string |
|
); |
|
Parameters
lpsz
Pointer to 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.
Return Values
If the
operand is a character string, the function returns a pointer to the converted
string. Since 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.
Remarks
Windows
NT: To make the conversion, the
function uses the language driver for the current language selected by the user
at setup or by using the Control Panel. If no language has been selected,
Windows completes the conversion by using internal default mapping. The
conversion is made based on the code page associated with the process locale.
Windows
95: The function makes the conversion
based on the information associated with the user's default locale, which is
the locale selected by the user at setup or by using the Control Panel. Windows
95 does not have language drivers.
See Also