_ismbslead, _ismbstrail, _ismbslead_l, _ismbstrail_l

Статья
06/09/2015

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

Важно!

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

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, вызывается обработчик недопустимых параметров, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эти функции возвращают NULL и устанавливают для errno значение EINVAL.

Заметки

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

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

Требования

Подпрограмма	Обязательный заголовок	Необязательный заголовок
_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>