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
Локаль
Интерпретация последовательностей многобайтовых символов