_mbsbtype, _mbsbtype_l
Retorna o tipo de bytes em uma cadeia de caracteres.
.gif "Observação importante") 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 _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 de multibyte.count
Deslocamento de bytes do início da cadeia de caracteres.locale
A localidade usar.
Valor de retorno
_mbsbtype e _mbsbtype_lretornam um valor inteiro que indica o resultado de teste em bytes especificado.Constantes de manifesto na tabela a seguir são definidas em Mbctype.h.
Valor de Retorno |
Tipo de bytes |
|---|---|
_MBC_SINGLE (0) |
Caracteres de byte único.Por exemplo, na página de código _mbsbtype 932, retorna 0 se o byte especificado está dentro do intervalo 0x20 – ou – 0x7E 0xA1 0xDF. |
_MBC_LEAD (1) |
Byte inicial de caracteres de multibyte.Por exemplo, na página de código _mbsbtype 932, retorna 1 se o byte especificado está dentro do intervalo 0x81 – ou – 0x9F 0xE0 0xFC. |
_MBC_TRAIL (2) |
Byte à direita do caractere de multibyte.Por exemplo, na página de código _mbsbtype 932, retorna 2 se o byte especificado está dentro do intervalo 0x40 – ou – 0x7E 0x80 0xFC. |
_MBC_ILLEGAL (–1) |
a cadeia de caracteres deNULL , o caractere inválido, ou byte de NULL encontrado antes do byte no deslocamento count em mbstr. |
Comentários
A função de _mbsbtype determina o tipo de um byte em uma cadeia de caracteres de multibyte.A função examina somente o byte no deslocamento count em mbstr, ignorando caracteres inválidos antes de bytes especificado.
O valor de saída é afetado pela configuração da categoria de LC_CTYPE de localidade; consulte setlocale para mais informações.A versão dessa função sem o sufixo de _l usa a localidade atual para este comportamento de são dependentes; a versão com o sufixo de _l é idêntica exceto que ela uso de localidade que o parâmetro passado em vez disso.Para obter mais informações, consulte Localidade.
Se a cadeia de caracteres de entrada é NULL, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, errno é definido como EINVAL e a função retorna _MBC_ILLEGAL.
Requisitos
Rotina |
Cabeçalho necessário |
Cabeçalho opcional |
|---|---|---|
_mbsbtype |
<mbstring.h> |
<mbctype.h>* |
_mbsbtype_l |
<mbstring.h> |
<mbctype.h>* |
* Para as constantes de manifesto usadas como valores de retorno.
Para mais informações, consulte Compatibilidade de compatibilidade na introdução.
Equivalência do .NET Framework
Não aplicável, mas System::Globalization::CultureInfoconsulte.