_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

  • Artigo

Verifica se um caractere multibyte é um caractere de símbolo ou legal.

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 _ismbclegal(
   unsigned int c
);
int _ismbclegal_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcsymbol(
   unsigned int c
);
int _ismbcsymbol_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.

As versões dessas funções com o sufixo _l são idênticas, exceto por usarem a localidade passada em vez da localidade atual para seu comportamento que depende da localidade. Para obter mais informações, consulte Localidade.

Rotina Condição de teste Exemplo da página de código 932
_ismbclegal Multibyte válido Retornará um valor diferente de zero se e somente se o primeiro byte de c estiver dentro dos intervalos 0x81 – 0x9F ou 0xE0 – 0xFC, enquanto o segundo byte estiver dentro dos intervalos 0x40 – 0x7E ou 0x80 – FC.
_ismbcsymbol Símbolo multibyte Retornará um valor diferente de zero se e somente se 0x8141<=c<=0x81AC.

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

Mapeamentos de rotina de texto genérico

Rotina Tchar.h _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_istlegal Sempre retorna falso _ismbclegal Sempre retorna falso.
_istlegal_l Sempre retorna falso _ismbclegal_l Sempre retorna falso.

Requisitos

Rotina Cabeçalho necessário
_ismbclegal, _ismbclegal_l <mbstring.h>
_ismbcsymbol, _ismbcsymbol_l <mbstring.h>

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

Confira também

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