Функция CharUpper

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

Синтаксис

Параметры

[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