_ismbslead, _ismbstrail, _ismbslead_l, _ismbstrail_l

Artigo
06/09/2015

Executar testes contextuais para bytes iniciais e finais bytes de multibyte-caractere- cadeia de caracteres e determina se um determinado ponteiro de subcadeia de caracteres aponta para um byte inicial ou a um byte final.

Importante

Não é possível usar essa API em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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 ser testado.
locale
A localidade a ser usada.

Valor de retorno

_ismbslead 1 será retornado se o caractere for um byte inicial e _ismbstrail 1 será retornado se o caractere for 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 retornam zero dessas funções. Se o argumento for NULL, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução puder continuar, essas funções retornarão NULL e definirão errno para EINVAL.

Comentários

_ismbslead e _ismbstrail é mais lenta do que as versões de _ismbblead e de _ismbbtrail porque leva em conta o contexto de cadeia de caracteres.

As versões dessas funções que têm o sufixo de _l são idênticas à o de seu comportamento dependente do que usam a localidade que é passada em vez da 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>