Функция CharLowerBuffA (winuser.h)

Статья
11/20/2024

Преобразует прописные символы в буфер в строчные символы. Функция преобразует символы на месте.

Синтаксис

DWORD CharLowerBuffA(
  [in, out] LPSTR lpsz,
  [in]      DWORD cchLength
);

Параметры

[in, out] lpsz

Тип: LPTSTR

Буфер, содержащий один или несколько символов для обработки.

[in] cchLength

Тип: DWORD

Размер буфера в символах, на который указывает lpsz. Функция проверяет каждый символ и преобразует прописные символы в строчные символы. Функция проверяет количество символов, указанных cchLength, даже если один или несколько символов имеют значение NULL.

Возвращаемое значение

Тип: DWORD

Возвращаемое значение — это количество обработанных символов. Например, если CharLowerBuff("Acme of Operating Systems", 10) успешно, возвращаемое значение равно 10.

Замечания

Обратите внимание, что CharLowerBuff всегда сопоставляет верхний регистр i с строчным регистром i ("i"), даже если текущий язык является турецким или азербайджанским. Если вам нужна функция, которая лингвистически учитывается в этом отношении, вызовите LCMapSting.

Преобразование в Юникод в версии функции ANSI выполняется с языковым стандартом по умолчанию системы во всех случаях.

Примеры

Пример см. в разделе "Создание диалогового окна орфографии" в использование полей со списком.

Заметка

Заголовок winuser.h определяет CharLowerBuff как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll