Поделиться через

_ismbslead, , _ismbstrail_ismbslead_l_ismbstrail_l

  • Статья

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

Внимание

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

Синтаксис

int _ismbslead(
   const unsigned char *str,
   const unsigned char *current
);
int _ismbstrail(
   const unsigned char *str,
   const unsigned char *current
);
int _ismbslead_l(
   const unsigned char *str,
   const unsigned char *current,
   _locale_t locale
);
int _ismbstrail_l(
   const unsigned char *str,
   const unsigned char *current,
   _locale_t locale
);

Параметры

str
Указатель на начало строки или на предыдущий известный старший байт.

current
Указатель на позицию в строке, которую нужно протестировать.

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

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

_ismbslead возвращает значение -1, если символ является байтом свинца и _ismbstrail возвращает -1, если символ является байтом следа. Если входные строки допустимы, но не являются байтами свинца или байтами тропы, эти функции возвращают ноль. Если один из аргументов имеет значение NULL, вызывается обработчик недопустимых параметров, как описано в разделе "Проверка параметров". Если продолжение выполнения разрешено, эти функции возвращают NULL и устанавливают для errno значение EINVAL.

Замечания

_ismbslead и _ismbstrail выполняются медленнее, чем версии _ismbblead и _ismbbtrail, так как учитывает контекст строки.

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

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

Требования

Маршрут Обязательный заголовок Необязательный заголовок
_ismbslead <mbctype.h> или <mbstring.h> <ctype.h,* <limits.h>, <stdlib.h>>
_ismbstrail <mbctype.h> или <mbstring.h> <ctype.h,* <limits.h>, <stdlib.h>>
_ismbslead_l <mbctype.h> или <mbstring.h> <ctype.h,* <limits.h>, <stdlib.h>>
_ismbstrail_l <mbctype.h> или <mbstring.h> <ctype.h,* <limits.h>, <stdlib.h>>

* Для констант манифеста для условий теста.

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

См. также

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