Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

CharLowerBuff function

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

Syntax


DWORD WINAPI CharLowerBuff(
  _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 uppercase characters to lowercase 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 CharLowerBuff("Acme of Operating Systems", 10) succeeds, the return value is 10.

Remarks

Note that CharLowerBuff always maps uppercase I to lowercase I ("i"), even when the current language is Turkish or Azeri. If you need a function that is linguistically sensitive in this respect, call LCMapSting.

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 a Spell Dialog Box" in Using Combo Boxes.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

Unicode and ANSI names

CharLowerBuffW (Unicode) and CharLowerBuffA (ANSI)

See also

Reference
CharLower
CharUpper
CharUpperBuff
Conceptual
Strings

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.