CharUpperBuffW function (winuser.h)

Article
02/22/2024

Converts lowercase characters in a buffer to uppercase characters. The function converts the characters in place.

Syntax

DWORD CharUpperBuffW(
  [in, out] LPWSTR lpsz,
  [in]      DWORD  cchLength
);

Parameters

[in, out] lpsz

Type: LPTSTR

A buffer containing one or more characters to be processed.

[in] cchLength

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.

Note

The winuser.h header defines CharUpperBuff as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll

Share via