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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in, out] lpsz

Тип: LPTSTR

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

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

Тип: LPTSTR

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

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

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

Замечания

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

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

Заметка

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

Требования

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