Функция CharUpperBuff преобразует в буфере символы нижнего регистра в символы верхнего регистра. Функция преобразует символы на месте.
DWORD CharUpperBuff( LPTSTR lpsz, DWORD cchLength ); |
[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. | |
Замечания по платформе | Не имеется |