Partilhar via

_ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, , _ismbcl2_l

  • Artigo

Funções específicas da página de código 932, usando a localidade atual ou uma categoria de estado de conversão LC_CTYPE especificada.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

int _ismbcl0(
   unsigned int c
);
int _ismbcl0_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcl1(
   unsigned int c
);
int _ismbcl1_l(
   unsigned int c ,
   _locale_t locale
);
int _ismbcl2(
   unsigned int c
);
int _ismbcl2_l(
   unsigned int c,
   _locale_t locale
);

Parâmetros

c
Caractere a ser testado.

locale
Localidade a usar.

Valor retornado

Cada uma dessas rotinas retornará um valor diferente de zero se o caractere atender à condição de teste. Caso contrário, eles retornarão 0. Se c<= 255 e houver uma rotina correspondente _ismbb (por exemplo, _ismbcalnum corresponde a _ismbbalnum), o resultado será o valor retornado da rotina correspondente _ismbb .

Comentários

Cada uma dessas funções testa um determinado caractere multibyte quanto a uma determinada condição.

O valor de saída é afetado pela configuração da categoria LC_CTYPE da localidade. Para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual desse comportamento dependente da localidade. As versões com o sufixo _l são idênticas, exceto por usarem o parâmetro de localidade passado em seu lugar. Para obter mais informações, consulte Localidade.

Rotina Condição de teste (página de código 932 somente)
_ismbcl0 JIS não Kanji: 0x8140<=c<=0x889E.
_ismbcl0_l JIS não Kanji: 0x8140<=c<=0x889E.
_ismbcl1 JIS nível 1: 0x889F<=c<=0x9872.
_ismbcl1_l JIS nível 1: 0x889F<=c<=0x9872.
_ismbcl2 JIS nível-2: 0x989F<=c<=0xEAA4.
_ismbcl2_l JIS nível-2: 0x989F<=c<=0xEAA4.

As funções verificam se o valor c especificado corresponde às condições de teste descritas acima, mas não verificam se c é um caractere multibyte válido. Se o byte inferior estiver nos intervalos 0x00 – 0x3F, 0x7F ou 0xFD – 0xFF, essas funções retornarão um valor diferente de zero, indicando que o caractere satisfaz a condição de teste. Use _ismbbtrail para testar se o caractere multibyte está definido.

Final específico da página de código 932

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Rotina Cabeçalho necessário
_ismbcl0 <mbstring.h>
_ismbcl0_l <mbstring.h>
_ismbcl1 <mbstring.h>
_ismbcl1_l <mbstring.h>
_ismbcl2 <mbstring.h>
_ismbcl2_l <mbstring.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Classificação de personagens
_ismbc Rotinas
Rotinas is e isw