_ismbslead, _ismbstrail, _ismbslead_l, _ismbstrail_l

Artigo
02/25/2013

Realiza teste contextuais para bytes inicial e final de bytes multibyte-caractere- cadeia de caracteres e determina se um determinado ponteiro da subcadeia de caracteres aponta para um byte inicial ou para um byte final.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 );

Parâmetros

str
Ponteiro para o início da cadeia de caracteres ou byte inicial conhecido anterior.
current
Ponteiro para a posição na cadeia de caracteres testado.
locale
A localidade a ser usada.

Valor de retorno

_ismbslead retorna 1 – se o caractere é um byte inicial e _ismbstrail retorna 1 – se o caractere é um byte final.Se as cadeias de caracteres de entrada são válidos mas não é um byte inicial ou um byte final, o retorno zero dessas funções.Se qualquer argumento é NULL, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, essas funções NULL de retorno e errno defina a EINVAL.

Comentários

_ismbslead e _ismbstrail são mais lentas que as versões de _ismbblead e de _ismbbtrail porque leva em consideração o contexto de cadeia de caracteres.

As versões dessas funções que têm o sufixo de _l são idênticas exceto que para o comportamento do são dependentes usam a localidade que são passadas em vez de localidade atual.Para obter mais informações, consulte Localidade.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_ismbslead	<mbctype.h> ou <mbstring.h>	<ctype.h>, * <limits.h>, <stdlib.h>
_ismbstrail	<mbctype.h> ou <mbstring.h>	<ctype.h>, * <limits.h>, <stdlib.h>
_ismbslead_l	<mbctype.h> ou <mbstring.h>	<ctype.h>, * <limits.h>, <stdlib.h>
_ismbstrail_l	<mbctype.h> ou <mbstring.h>	<ctype.h>, * <limits.h>, <stdlib.h>