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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in, out] lpsz

Тип: LPTSTR

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

[in] cchLength

Тип: DWORD

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

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

Тип: DWORD

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

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

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

Примеры

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll