CharUpperBuff function
Converts lowercase characters in a buffer to uppercase characters. The function converts the characters in place.
Syntax
DWORD WINAPI CharUpperBuff( _Inout_ LPTSTR lpsz, _In_ DWORD cchLength );
Parameters
- lpsz [in, out]
-
Type: LPTSTR
A buffer containing one or more characters to be processed.
- cchLength [in]
-
Type: DWORD
The size, in characters, of the buffer pointed to by lpsz.
The function examines each character, and converts lowercase characters to uppercase characters. The function examines the number of characters indicated by cchLength, even if one or more characters are null characters.
Return value
Type: DWORD
The return value is the number of characters processed.
For example, if CharUpperBuff("Zenith of API Sets", 10) succeeds, the return value is 10.
Remarks
Note that CharUpperBuff 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.
Examples
For an example, see Creating and Using a Temporary File.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
CharUpperBuffW (Unicode) and CharUpperBuffA (ANSI) |
See also
- Reference
- CharLower
- CharLowerBuff
- CharUpper
- Conceptual
- Strings