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

Статья
08/27/2023

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

Синтаксис

LPWSTR CharLowerW(
  [in, out] LPWSTR lpsz
);

Параметры

[in, out] lpsz

Тип: LPTSTR

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

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

Тип: LPTSTR

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

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

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

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

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

Примечание

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

Требования


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