_ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, _ismbcl2_l

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.

Retornar valor

Cada uma dessas rotinas retornará um valor diferente de zero se o caractere satisfizer a condição de teste. Caso contrário, eles retornam 0. Se c<= 255 e houver uma rotina correspondente (por exemplo, _ismbcalnum corresponde a _ismbbalnum), o resultado é o valor de retorno da rotina correspondente _ismbb_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, consulte Estado global na 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 caracteres
_ismbc Rotinas
Rotinas is e isw