toupper, _toupper, towupper, _toupper_l, _towupper_l

Статья
06/09/2015

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

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.

Нет зарезервированных возвращаемых значений для указания ошибки.

Для того, чтобы toupper вернула ожидаемый результат, функции __isascii и islower должны вернуть ненулевое значение.

Заметки

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

Для того, чтобы toupper вернула ожидаемый результат, функции __isascii и isupper должны вернуть ненулевое значение.

Процедуры преобразования данных

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Примечание

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