Rotinas _ismbb
Testa o valor inteiro dado c para uma determinada condição, usando a localidade atual ou uma categoria de estado de conversão LC_CTYPE especificada.
_ismbbalnum, _ismbbalnum_l
_ismbbalpha, _ismbbalpha_l
_ismbbblank, _ismbbblank_l
_ismbbgraph, _ismbbgraph_l
_ismbbkalnum, _ismbbkalnum_l
_ismbbkana, _ismbbkana_l
_ismbbkprint, _ismbbkprint_l
_ismbbkpunct, _ismbbkpunct_l
_ismbblead, _ismbblead_l
_ismbbprint, _ismbbprint_l
_ismbbpunct, _ismbbpunct_l
_ismbbtrail, _ismbbtrail_l\
Comentários
Cada rotina na família _ismbb testa o valor inteiro dado c para uma determinada condição. O resultado do teste depende da página de código multibyte que está em vigor. Por padrão, a página de código multibyte é definida para a página de código ANSI obtida do sistema operacional na inicialização do programa. Você pode usar _getmbcp para consultar a página de código multibyte em uso ou _setmbcp para alterá-la.
O valor de saída é afetado pela configuração da categoria LC_CTYPE da localidade; confira setlocale e _wsetlocale para obter mais informações. As versões dessas funções que não têm o sufixo _l, usam a localidade atual para esse comportamento dependente de localidade; as versões com o sufixo_l são idênticas, exceto que, em vez disso, usam o parâmetro de localidade informado.
As rotinas na família _ismbb testam o inteiro dado c da seguinte maneira.
| Rotina | Condição de teste de byte |
|---|---|
_ismbbalnum |
isalnum(c) || _ismbbkalnum(c) |
_ismbbalpha |
isalpha(c) || _ismbbkalpha(c) |
_ismbbblank |
isblank(c) |
_ismbbgraph |
O mesmo que _ismbbprint, mas _ismbbgraph não inclui o caractere de espaço (0x20). |
_ismbbkalnum |
Símbolo de texto não ASCII que não seja de pontuação. Por exemplo, na página de código 932 somente, _ismbbkalnum testa se é um alfanumérico katakana |
_ismbbkana |
Katakana (0xA1 – 0xDF). Específico para a página de código 932 |
_ismbbkprint |
Texto não ASCII ou símbolo de pontuação não ASCII. Por exemplo, somente na página de código 932, _ismbbkprint testa se há pontuação katakana ou caracteres alfanuméricos katakana (intervalo: 0xA1 – 0xDF) |
_ismbbkpunct |
Pontuação não ASCII. Por exemplo, na página de código 932 somente, _ismbbkpunct testa se é uma pontuação katakana |
_ismbblead |
Byte inicial do caractere multibyte. Por exemplo, somente na página de código 932, os intervalos válidos são 0x81 a 0x9F e 0xE0 a 0xFC |
_ismbbprint |
isprint(c) || _ismbbkprint(c). ismbbprint inclui o caractere de espaço (0x20) |
_ismbbpunct |
ispunct(c) || _ismbbkpunct(c). |
_ismbbtrail |
Segundo byte do caractere multibyte. Por exemplo, somente na página de código 932, os intervalos válidos são 0x40 a 0x7E e 0x80 a 0xEC |
A tabela a seguir mostra os valores combinados de | que compõem as condições de teste dessas rotinas. As constantes de manifesto _BLANK, _DIGIT, _LOWER, _PUNCT e _UPPER são definidas em ctype.h.
| Rotina | _BLANK |
_DIGIT |
LOWER |
_PUNCT |
UPPER |
Não ASCII text |
Não ASCII pontuação |
|---|---|---|---|---|---|---|---|
_ismbbalnum |
— | x | x | — | x | x | — |
_ismbbalpha |
— | — | x | — | x | x | — |
_ismbbblank |
x | — | — | — | — | — | — |
_ismbbgraph |
— | x | x | x | x | x | x |
_ismbbkalnum |
— | — | — | — | — | x | — |
_ismbbkprint |
— | — | — | — | — | x | x |
_ismbbkpunct |
— | — | — | — | — | — | x |
_ismbbprint |
x | x | x | x | x | x | x |
_ismbbpunct |
— | — | — | x | — | — | x |
As rotinas _ismbb são implementadas como funções e macros. Para obter informações sobre como escolher a implementação, confira Recomendações para escolher entre funções e macros.
Confira também
Classificação de bytes
Rotinas is e isw
_mbbtombc, _mbbtombc_l
_mbctombb, _mbctombb_l