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

Статья
11/20/2024

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

Синтаксис

LPSTR CharLowerA(
  [in, out] LPSTR lpsz
);

Параметры

[in, out] lpsz

Тип: LPTSTR

Строка, завершающаяся значением NULL, или задает один символ. Если слово высокого порядка этого параметра равно нулю, слово с низким порядком должно содержать один символ для преобразования.

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

Тип: LPTSTR

Если операнд является символьной строкой, функция возвращает указатель на преобразованную строку. Так как строка преобразуется на месте, возвращаемое значение равно lpsz.

Если операнд является одним символом, возвращаемое значение представляет собой 32-разрядное значение, значение которого равно нулю, а слово с низким порядком содержит преобразованный символ.

Нет никаких признаков успеха или сбоя. Сбой является редким. Для этой функции нет расширенных сведений об ошибке; не вызывайте GetLastError.

Замечания

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

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

Заметка

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

Требования

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