_ismbcalnum
, _ismbcalnum_l
, _ismbcalpha
, _ismbcalpha_l
, _ismbcdigit
, , _ismbcdigit_l
Verifica se um caractere multibyte é um alfanumérico, alfa ou um caractere de dígito.
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 _ismbcalnum
(
unsigned int c
);
int _ismbcalnum_l
(
unsigned int c,
_locale_t locale
);
int _ismbcalpha
(
unsigned int c
);
int _ismbcalpha_l
(
unsigned int c,
_locale_t locale
);
int _ismbcdigit
(
unsigned int c
);
int _ismbcdigit_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 rotinas 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 |
---|---|---|
_ismbcalnum , _ismbcalnum_l |
Alfanumérico | Retornará um valor diferente de zero se e somente se c for uma representação de byte único de uma letra ASCII em inglês: consulte exemplos para _ismbcdigit e _ismbcalpha . |
_ismbcalpha , _ismbcalpha_l |
Alfabético | Retorna diferente de zero se e somente se c for uma representação de byte único de uma letra ASCII em inglês: 0x41<=c <=0x5A ou 0x61<=c <=0x7A; ou uma letra katakana: 0xA6<=c <=0xDF. |
_ismbcdigit , _ismbcdigit_l |
Digit | Retornará um valor diferente de zero se e somente se c for uma representação de um byte de um dígito ASCII: 0x30<=c <=0x39. |
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 |
---|---|
_ismbcalnum , _ismbcalnum_l |
<mbstring.h> |
_ismbcalpha , _ismbcalpha_l |
<mbstring.h> |
_ismbcdigit , _ismbcdigit_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