_mbbtype, _mbbtype_l

Artigo
06/09/2015

Retorna o tipo de byte, com base em bytes anterior.

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 _mbbtype(
   unsigned char c,
   int type 
);
int _mbbtype_l(
   unsigned char c,
   int type,
   _locale_t locale
);

Parâmetros

c
O caractere a ser testada.
type
O tipo de byte para testar.
locale
A localidade a ser usada.

Valor de retorno

_mbbtype retorna o tipo de bytes em uma cadeia de caracteres. Esta decisão é contextual, como especificado pelo valor de type, que fornece a condição de teste de controle. type é o tipo de byte anterior da cadeia de caracteres. As constantes de manifesto na tabela a seguir são definidas em Mbctype.h.

Valor de type	teste de_mbbtype para	Valor de retorno	c
Qualquer valor exceptua 1	Byte único válido ou byte inicial	_MBC_SINGLE (0)	Único byte (0x20 – 0x7E, 0xA1 – 0xDF)
Qualquer valor exceptua 1	Byte único válido ou byte inicial	_MBC_LEAD (1)	Byte inicial de caracteres multibyte (0x81 – 0x9F, 0xE0 – 0xFC)
Qualquer valor exceptua 1	Um byte válido ou byte inicial	_MBC_ILLEGAL ( –1)	Caractere inválido (qualquer valor exceptua 0x20 – 0x7E, 0xA1 – 0xDF, 0x81 – 0x9F, 0xE0 – 0xFC
1	Byte final válido	_MBC_TRAIL (2)	Bytes à direita de caracteres multibyte (0x40 – 0x7E, 0x80 – 0xFC)
1	Byte final válido	_MBC_ILLEGAL ( –1)	Caractere inválido (qualquer valor exceptua 0x20 – 0x7E, 0xA1 – 0xDF, 0x81 – 0x9F, 0xE0 – 0xFC

Comentários

A função de _mbbtype determina o tipo de um byte em um caracteres multibyte. Se o valor de type for qualquer valor 1, exceto teste de _mbbtype para um byte único ou um byte inicial válida de um caracteres multibyte. Se o valor de type é 1, teste de _mbbtype para um byte final válida de um caracteres multibyte.

O valor de saída é afetado pela configuração da categoria LC_CTYPE de localidade. Para obter mais informações, consulte setlocale, _wsetlocale. A versão de _mbbtype dessa função usa a localidade atual para este comportamento dependente de localidade; a versão de _mbbtype_l é idêntica a menos que ele use o parâmetro de localidade que é passado por vez. Para obter mais informações, consulte Localidade.

Em versões anteriores, _mbbtype foi nomeada chkctype. Para o novo código, use _mbbtype em vez disso.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_mbbtype	<mbstring.h>	<mbctype.h>*
_mbbtype_l	<mbstring.h>	<mbctype.h>*

* Para definições de constantes manifestas que são usadas como valores de retorno.

Para obter mais informações de compatibilidade, consulte Compatibilidade.

Equivalência do .NET Framework

Não aplicável, mas consulte System::Globalization::CultureInfo.

Consulte também

Referência

Classificação de byte

Compartilhar via