_ismbblead, _ismbblead_l

  • Artigo

Testa um caractere para determinar se ele é um byte inicial ou um caractere multibyte.

Sintaxe

int _ismbblead(
   unsigned int c
);
int _ismbblead_l(
   unsigned int c,
   _locale_t locale
);

Parâmetros

c
Inteiro a ser testado.

locale
Localidade a usar.

Valor retornado

Retornará um valor diferente de zero se o inteiro c for o primeiro byte de um caractere multibyte.

Comentários

Caracteres multibyte consistem em um byte inicial seguido de um byte à direita. Bytes iniciais são diferenciados por estarem em um intervalo específico de um determinado conjunto de caracteres. Por exemplo, somente na página de código 932, os bytes iniciais vão de 0x81 a 0x9F e de 0xE0 a 0xFC.

_ismbblead usa a localidade atual para comportamentos que dependem da localidade. _ismbblead_l é idêntico, exceto pelo fato de usar a localidade passada. Para obter mais informações, consulte Localidade.

Quando a localidade é UTF-8 _ismbblead e _ismbblead_l sempre retorna 0 (false), seja c um byte principal ou não.

_ismbblead e _ismbblead_l são específicos da Microsoft, não fazem parte da biblioteca C padrão. Não recomendamos que você as use se quiser um código portátil. Para compatibilidade com o padrão C, use mbrlen em vez disso.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_istlead Sempre retorna falso _ismbblead Sempre retorna falso

Requisitos

Rotina Cabeçalho necessário Cabeçalho opcional
_ismbblead <mbctype.h> ou <mbstring.h> <ctype.h>,* <limits.h>, <stdlib.h>
_ismbblead_l <mbctype.h> ou <mbstring.h> <ctype.h>,* <limits.h>, <stdlib.h>

* Para constantes de manifesto para as condições de teste.

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Classificação de bytes
_ismbb Rotinas
mbrlen