Share via

_mbsbtype, _mbsbtype_l

  • Artigo

Retorna o tipo de byte dentro de uma seqüência.

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
    Offset do chefe da seqüência de caracteres de byte.

  • locale
    Localidade usar.

Valor de retorno

_mbsbtype and _mbsbtype_lreturns an integer value indicating the result of the test on the specified byte.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, em página de código 932, _mbsbtype Retorna 0 se o byte especificado está no intervalo de 0 x 20 – 0x7E ou 0xA1 – 0xDF.

_MBC_LEAD (1)

Levar o byte inicial de caractere multibyte.Por exemplo, em página de código 932, _mbsbtype Retorna 1 se o byte especificado está no intervalo de 0 x 81 – 0x9F ou 0xE0 – 0xFC.

_MBC_TRAIL (2)

Byte de caractere multibyte.Por exemplo, no código de página 932, _mbsbtype Retorna 2 se o byte especificado está no intervalo de 0 x 40 – 0x7E ou 0 x 80 – 0xFC.

_MBC_ILLEGAL (–1)

NULL seqüência de caracteres, o caractere inválido, ou NULL encontrado antes de byte no deslocamento de byte count em mbstr.

Comentários

The _mbsbtype função determina o tipo de um byte em uma seqüência de caractere multibyte. A função examina somente o byte no deslocamento count em mbstr, ignorando caracteres inválidos antes do byte especificado.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.A versão dessa função sem o _l sufixo usa a localidade corrente para esse comportamento dependente de localidade; a versão com o _l sufixo é idêntico, exceto pelo fato de que ele usar o parâmetro de localidade passado em vez disso. For more information, see Localidade.

Se a seqüência de entrada for NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para 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 o manifesto de constantes usados sistema autônomo valores de retorno.

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Equivalente do NET Framework

Não aplicável, mas verá sistema::globalização::CultureInfo.

Consulte também

Referência

Classificação de byte