_mbsbtype, _mbsbtype_l

Artigo
06/09/2015

Retorna o tipo de bytes em uma cadeia de caracteres.

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

int _mbsbtype(
   const unsigned char *mbstr,
   size_t count 
);
int _mbsbtype_l(
   const unsigned char *mbstr,
   size_t count,
   _locale_t locale 
);

Parâmetros

mbstr
Endereço de uma sequência de caracteres multibyte.
count
Cabeçalho de deslocamento de byte da cadeia de caracteres.
locale
Localidade a ser usada.

Valor de retorno

_mbsbtype e _mbsbtype_lretornam um valor inteiro que indica o resultado de teste no byte especificado. As constantes de manifesto na tabela a seguir são definidas em Mbctype.h.

Valor de retorno	Tipo de byte
_MBC_SINGLE (0)	Caractere de byte único. Por exemplo, na página de código 932, _mbsbtype retorna 0 se o byte especificado estiver dentro do intervalo de 0x20 a 0x7E ou de 0xA1 a 0xDF.
_MBC_LEAD (1)	Primeiro byte do caractere de multibyte. Por exemplo, na página de código 932, _mbsbtype retorna 1 se o byte especificado estiver dentro do intervalo de 0x81 a 0x9F ou de 0xE0 a 0xFC.
_MBC_TRAIL (2)	Byte à direita de caractere multibyte. Por exemplo, na página de código 932, _mbsbtype retorna 2 se o byte especificado estiver dentro do intervalo de 0x40 a 0x7E ou de 0x80 a 0xFC.
_MBC_ILLEGAL (–1)	NULL cadeia de caracteres, caractere inválido ou NULL byte encontrado antes do byte no deslocamento count em mbstr.

Comentários

A função _mbsbtype determina o tipo de um byte em uma cadeia de caracteres multibyte. A função examina somente o byte no deslocamento count em mbstr, ignorando os caracteres inválidos antes do bytes especificado.

O valor de saída é afetado pela configuração da categoria LC_CTYPE de localidade. Para obter mais informações, consulte setlocale. A versão dessa função sem o sufixo _l usa a localidade atual para esse comportamento dependente da localidade; a versão com o sufixo _l é idêntica, exceto pelo fato de que ela usa o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

Se a cadeia de caracteres de entrada for NULL, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a execução puder continuar, errno será definido como EINVAL e a função retornará _MBC_ILLEGAL.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_mbsbtype	<mbstring.h>	<mbctype.h>*
_mbsbtype_l	<mbstring.h>	<mbctype.h>*

* No caso de constantes de manifesto usadas como valores de retorno.

Para obter mais informações sobre 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