_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Статья
06/09/2015

Проверяет и преобразовывает регистр многобайтового символа.

Важно!

Этот API невозможно использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в статье Функции CRT, которые не поддерживаются с ключом /ZW.

unsigned int _mbctolower(
   unsigned int c 
);
unsigned int _mbctolower_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctoupper(
   unsigned int c 
);
unsigned int _mbctoupper_l(
   unsigned int c,
   _locale_t locale
);

Параметры

c
Многобайтовый символ для преобразования.
locale
Языковой стандарт, который необходимо использовать.

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

Каждая из этих функций возвращает преобразованный символ c, если это возможно. В противном случае символ c возвращается без изменений.

Заметки

Функции проверяют символ c и, если это возможно, выполняют одно из следующих преобразований.

Программы	Преобразования
_mbctolower,_mbctolower_l	Символ верхнего регистра к символу нижнего регистра.
_mbctoupper,_mbctoupper_l	Символ нижнего регистра к символу верхнего регистра.

Выходное значение зависит от настройки категории LC_CTYPE языкового стандарта; дополнительные сведения см. в разделе setlocale. Версия этой функции без суффикса _l использует текущий языковой стандарт для данной функциональности, зависящей от языкового стандарта; версия с суффиксом _l идентична, за исключением того, что она использует переданный параметр языкового стандарта. Для получения дополнительной информации см. Языковой стандарт.

В предыдущих версиях, _mbctolower называлась jtolower, и _mbctoupper называлась jtoupper. Для нового кода используйте эти новые имена.

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определены	_MBCS определено	_UNICODE определено
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_t
_totupper	toupper	_mbctoupper	towupper
_totupper_l	toupper_l	_mbctoupper_l	_towupper_l