Функция CharUpperBuff

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

Синтаксис

DWORD CharUpperBuff(      

    LPTSTR lpsz,
    DWORD cchLength
);

Параметры

lpsz

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

cchLength

[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

Размещение и совместимость CharUpperBuff

К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1
в
е
р
Используемая библиотека User32.lib
Используемая DLL user32.dll
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode Реализуются как версии Unicode и ANSI.
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz