Classificação de caractere

Cada uma dessas rotinas testa um caractere especificado de byte único, caractere amplo, ou caractere de multibyte para satisfazer uma condição. (Por definição, o conjunto de caracteres ASCII entre 0 e 127 é um subconjunto de todos os conjuntos de caracteres multibyte. Por exemplo, o katakana japonês inclui caracteres ASCII bem como não-ASCII.

As condições de teste são afetadas pela configuração da categoria LC_CTYPE de localidade. Para obter mais informações, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual para esse comportamento dependente da localidade; as versões com o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado.

Geralmente essas rotinas executam mais rápido do que os testes que você pode escrever e devem ser favorecidas. Por exemplo, o código a seguir é executado mais lento do que uma chamada para isalpha(c):

if ((c >= 'A') && (c <= 'Z')) || ((c >= 'a') && (c <= 'z'))
    return TRUE;

Rotinas de classificação de caracteres

Rotina	Condição de teste de caracteres	Equivalente a .NET Framework
isalnum, iswalnum, _isalnum_l, _iswalnum_l, _ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l	Alfanumérico	System::Char::IsLetterOrDigit.
_ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l	Alfanumérico	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
isalpha, iswalpha, _isalpha_l, _iswalpha_l, _ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l	Alfabético	System::Char::IsLetter
__isascii, iswascii	ASCII	System::Char::IsLetter
isblank, iswblank, _isblank_l, _iswblank_l, _ismbcsblank, _ismbcsblank_l	Em branco (espaço ou guia horizontal)	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
iscntrl, iswcntrl, _iscntrl_l, _iswcntrl_l	Controle	System::Char::IsControl
__iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, _iswcsymf_l	Letra, sublinhado ou dígito	System::Char::IsControl
__iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, _iswcsymf_l	Letra ou sublinhado	System::Char::IsControl
isdigit, iswdigit, _isdigit_l, _iswdigit_l, _ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l	Dígito decimal	System::Char::IsDigit
isgraph, iswgraph, _isgraph_l, _iswgraph_l, _ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcblank, _ismbcblank_l, _ismbcspace, _ismbcspace_l	Imprimível a não ser o espaço	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
islower, iswlower, _islower_l, _iswlower_l, _ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_l	Minúsculas	System::Char::IsLower
_ismbchira, _ismbchira_l, _ismbckata, _ismbckata_l	Hiragana	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
_ismbchira, _ismbchira_l, _ismbckata, _ismbckata_l	Katakana	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l	Caractere válido de multibyte	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
_ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, _ismbcl2_l	Caractere de multibyte de nível 0 do Japão	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
_ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, _ismbcl2_l	Caractere de multibyte de nível 1 do Japão	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
_ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, _ismbcl2_l	Caractere de multibyte de nível 2 do Japão	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l	Caractere não alfanumérico de multibyte	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
isprint, iswprint, _isprint_l, _iswprint_l, _ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcblank, _ismbcblank_l, _ismbcspace, _ismbcspace_l	Para impressão	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
ispunct, iswpunct, _ispunct_l, _iswpunct_l, _ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcblank, _ismbcblank_l, _ismbcspace, _ismbcspace_l	Pontuação	System::Char::IsPunctuation
isspace, iswspace, _isspace_l, _iswspace_l, _ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcblank, _ismbcblank_l, _ismbcspace, _ismbcspace_l	Espaço em branco	System::Char::IsWhiteSpace
Isupper, iswupper, _ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_l	Maiúsculas	System::Char::IsUpper
_isctype, iswctype, _isctype_l, _iswctype_l	A propriedade especificada pelo argumento desc	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.
isxdigit, iswxdigit, _isxdigit_l, _iswxdigit_l	Dígito hexadecimal	System::Char::IsNumber
_mbclen, mblen, _mblen_l	Retorna o tamanho do caractere multibyte válido; o resultado depende da configuração da categoria LC_CTYPE da localidade atual	Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.

Consulte também

Referência

Rotinas de tempo de execução por categoria