Функция CharUpper


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

Синтаксис

LPTSTR CharUpper(      

    LPTSTR lpsz
);

Параметры

lpsz

[in, out] Указатель на строку с завершающим нулем или определенный единичный символ. Если старшее слово этого параметра - нуль, младшее слово должно содержать в себе единичный символ, который будет преобразован.

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

Если операнд - строка символов, возвращаемое значений функцией - указатель на преобразованную строку. Так как строка преобразуется на месте, возвращаемое значение равно lpsz.

Если операнд - единичный символ, возвращаемое значение - 32-разрядное значение, старшее слово которого - нуль, а младшее слово содержит в себе преобразованный символ.

Нет никакой индикации относительно успешного завершения или сбоя в работе функции. Такой сбой редок. Дополнительной информации об ошибке для этой функции нет; не вызывайте GetLastError - не поможет.

Замечания

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

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

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

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

Смотри также

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

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

К 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.
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки
Переведено 01.05.2009 14:45 ©Copyright V. Sokovikov
Hosted by uCoz