_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

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

Важно!

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

Синтаксис

int _ismbclegal(
   unsigned int c
);
int _ismbclegal_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcsymbol(
   unsigned int c
);
int _ismbcsymbol_l(
   unsigned int c,
   _locale_t locale
);

Параметры

c
Символ, который требуется проверить.

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

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

Каждая из этих подпрограмм возвращает ненулевое значение, если символ удовлетворяет условию теста. В противном случае они возвращают значение 0. Если c<= 255 и есть соответствующая _ismbb подпрограмма (например, _ismbcalnum соответствует _ismbbalnum), результатом является возвращаемое значение соответствующей _ismbb подпрограммы.

Замечания

Каждая из этих функций проверяет определенный многобайтовый символ на соответствие заданному условию.

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

Маршрут	Условие теста	Пример кодовой страницы 932
_ismbclegal	Допустимый многобайтовый символ	Возвращает ненулевое значение только в том случае, если первый байт c находится в диапазонах 0x81–0x9F или 0xE0–0xFC, а второй — в диапазонах 0x40–0x7E или 0x80–FC.
_ismbcsymbol	Многобайтовый символ	Возвращает ненулевое значение, если и только если 0x8141<=c<0x81AC.

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

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

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_istlegal	Всегда возвращает значение false	_ismbclegal	Всегда возвращает значение false.
_istlegal_l	Всегда возвращает значение false	_ismbclegal_l	Всегда возвращает значение false.

Требования

Маршрут	Обязательный заголовок
_ismbclegal, _ismbclegal_l	<mbstring.h>
_ismbcsymbol, _ismbcsymbol_l	<mbstring.h>

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

См. также

Классификация символов
_ismbc Процедуры
is, isw подпрограммы
_ismbb Процедуры