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

Статья
08/27/2023

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

Синтаксис

DWORD CharUpperBuffW(
  [in, out] LPWSTR lpsz,
  [in]      DWORD  cchLength
);

Параметры

[in, out] lpsz

Тип: LPTSTR

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

[in] cchLength

Тип: DWORD

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

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

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

Тип: DWORD

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

Например, если charUpperBuff("Zenith of API Sets", 10) успешно завершается, возвращается значение 10.

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

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

Примеры

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

Примечание

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

Требования


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