Функция CharUpperBuff

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

Синтаксис

Параметры

[in] Указатель на буфер, содержащий один или несколько обрабатываемых символов.

[in] Определяет размер буфера, указанный при помощи параметра lpsz, в TCHARs. Это относится к байтам для версии ANSI функции или WCHARs для версии Unicode.

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

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

Возвращаемое значение - число TCHARs, которое обрабатывается.

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

Замечания

Обратите внимание! на то, что функция CharUpper всегда отображает I нижнего регистра I в верхнем регистре, даже когда текущий язык является турецким или азербайджанским.

Windows NT/2000/XP: Чтобы сделать преобразование, функция использует драйвер языка для текущего языка, выбранного пользователем при установке системы или при помощи использования Панели Управления (Control Panel). Если язык не выбрался, система завершает преобразование при помощи использования внутреннего отображения по умолчанию. Преобразование делается на основе кодовой страницы, связанной с языком страны (местности) процесса.

Windows 95/98/Me: Функция делает преобразование основываясь на информации, связанной с языком страны (местности) пользователя по умолчанию, который является языком страны, выбранным пользователем при установке системы или при помощи использования Панели Управления (Control Panel). У системы нет драйверов языка.

Windows 95/98/Me: Функция CharUpperBuffW поддерживается Microsoft Layer for Unicode (MSLU). Чтобы использовать MLSU, Вы должны добавить некоторые файлы к своему приложению, как это определено в Microsoft Layer для Unicode для системной среды Windows 95/98/Me.

Пример

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

Смотри также

Обзор Строки, Функции, используемые строками, CharLower, CharLowerBuff, CharUpper