_mbsbtype, _mbsbtype_l

  • Artigo

Retorna o tipo de bytes em uma cadeia de caracteres.

Observação importanteImportante

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.

Consulte também

Referência

Classificação byte