Поделиться через

toupper, , _touppertowupper, _toupper_l_towupper_l

  • Статья

Преобразуют символ в верхний регистр.

Синтаксис

int toupper(
   int c
);
int _toupper(
   int c
);
int towupper(
   wint_t c
);
int _toupper_l(
   int c ,
   _locale_t locale
);
int _towupper_l(
   wint_t c ,
   _locale_t locale
);

Параметры

c
Символ для преобразования.

locale
Используемый языковой стандарт.

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

Каждая из этих подпрограмм преобразует копию c, если это преобразование возможно, и возвращает результат.

Если c имеется широкий символ, для которого iswlower ненулевой символ и имеется соответствующий широкий символ, для которого iswupper ненулевое значение, towupper возвращает соответствующий широкий символ; в противном случае towupper возвращается c без изменений.

Возвращаемое значение не зарезервировано для указания ошибки.

Замечания

Каждая из этих подпрограмм преобразует указанную строчную букву в прописную, если это возможно и уместно. Преобразование регистра towupper зависит от языкового стандарта. Изменяются только символы, соответствующие текущему языковому стандарту. Функции без суффикса _l используют текущий языковой стандарт. Версии этих функций с суффиксом _l идентичны функциям без суффикса, за исключением того, что они принимают языковой стандарт в качестве параметра и используют его вместо текущего языкового стандарта. Дополнительные сведения см. в разделе Locale.

Чтобы toupper дать ожидаемые результаты, __isascii необходимо вернуть ненулевое значение.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

TCHAR.H рутина _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_totupper toupper _mbctoupper towupper
_totupper_l _toupper_l _mbctoupper_l _towupper_l

Примечание.

Функции _toupper_l и _towupper_l не зависят от языкового стандарта и не предназначены для непосредственного вызова. Они предназначены для внутреннего использования _totupper_l.

Требования

Маршрут Обязательный заголовок
toupper <ctype.h>
_toupper <ctype.h>
towupper <ctype.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

См. пример в to функциях.

См. также

is, isw подпрограммы
Функции to
Локаль
Интерпретация последовательностей многобайтовых символов