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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in, out] lpsz

Тип: LPTSTR

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

[in] cchLength

Тип: DWORD

Размер буфера в символах, на который указывает lpsz.

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

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

Тип: DWORD

Возвращаемое значение — это количество обработанных символов.

Например, если CharUpperBuff("Zenith из наборов API", 10) успешно, возвращаемое значение равно 10.

Замечания

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

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

Примеры

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

Заметка

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

Требования

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