_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

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

Важно!

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

Синтаксис

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 идентична версии без суффикса, но использует переданный параметр языкового стандарта. Дополнительные сведения см. в разделе Locale.

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

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

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

Подпрограмма 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

Требования

Подпрограммы	Обязательный заголовок
_mbctolower, _mbctolower_l	<mbstring.h>
_mbctoupper, _mbctoupper_l	<mbstring.h>

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

См. также

Преобразование данных
_mbbtombc, _mbbtombc_l
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
_mbctombb, _mbctombb_l