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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in, out] lpsz

Тип: LPTSTR

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

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

Тип: LPTSTR

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

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

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

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

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

Примечание

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

Требования


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