Rotinas _ismbc

  • Artigo

Cada _ismbc rotina testa um determinado caractere c multibyte para uma condição específica.

Comentários

O resultado do teste de cada _ismbc rotina depende da página de código multibyte em vigor. Páginas de código multibyte têm caracteres alfabéticos de um byte. Por padrão, a página de código multibyte é definida para a página de código ANSI padrão do sistema obtida do sistema operacional na inicialização do programa. Você pode consultar ou alterar a página de código multibyte em uso com _getmbcp ou _setmbcp, respectivamente.

O valor de saída é afetado pela configuração de LC_CTYPE categoria 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.

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 Retornará um valor diferente de zero se e somente se c for uma representação de um byte de uma letra ASCII em inglês: confira exemplos de _ismbcupper e _ismbclower, 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.
_ismbcgraph, _ismbcgraph_l Graphic Retorna um valor diferente de zero se e somente se c for uma representação de byte único de qualquer caractere imprimível ASCII ou katakana, exceto por um espaço em branco ( ). Confira exemplos de _ismbcdigit, _ismbcalpha e _ismbcpunct.
_ismbclegal, _ismbclegal_l Caractere 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.
_ismbclower, _ismbclower_l Alfabético minúsculo Retorna um valor diferente de zero se e somente se c for uma representação de um byte de uma letra minúscula ASCII em inglês: 0x61<=c<=0x7A.
_ismbcprint, _ismbcprint_l Imprimível Retornará um valor diferente de zero se e somente se c for uma representação de byte único de qualquer caractere imprimível ASCII ou katakana, incluindo um espaço em branco ( ). Confira exemplos de _ismbcspace, _ismbcdigit, _ismbcalpha e _ismbcpunct.
_ismbcpunct, _ismbcpunct_l Pontuação Retorna um valor diferente de zero se e somente se c for uma representação de byte único de qualquer caractere de pontuação ASCII ou katakana.
_ismbcblank, _ismbcblank_l Espaço ou tabulação horizontal Retornará um valor diferente de zero se e somente se c for uma representação de byte único de um caractere de espaço ou um caractere de tabulação horizontal: c=0x20 ou c=0x09.
_ismbcspace, _ismbcspace_l Espaço em branco Retornará um valor diferente de zero se e somente se c for um caractere de espaço em branco: c=0x20 ou 0x09<=c<=0x0D.
_ismbcsymbol, _ismbcsymbol_l Símbolo multibyte Retornará um valor diferente de zero se e somente se 0x8141<=c<=0x81AC.
_ismbcupper, _ismbcupper_l Alfabético maiúsculo Retornará um valor diferente de zero se e somente se c for uma representação de um byte de uma letra maiúscula ASCII em inglês: 0x41<=c<=0x5A.

Específico da página de código 932

As seguintes rotinas são específicas para a página de código 932.

Rotina Condição de teste (página de código 932 somente)
_ismbchira, _ismbchira_l Hiragana de dois bytes: 0x829F<=c<=0x82F1.
_ismbckata, _ismbckata_l Katakana de dois bytes: 0x8340<=c<=0x8396.
_ismbcl0, _ismbcl0_l JIS não Kanji: 0x8140<=c<=0x889E.
_ismbcl1, _ismbcl1_l JIS nível 1: 0x889F<=c<=0x9872.
_ismbcl2, _ismbcl2_l JIS nível 2: 0x989F<=c<=0xEA9E.

_ismbcl0, _ismbcl1e _ismbcl2 verifique se o valor c especificado corresponde às condições de teste descritas na tabela anterior, mas não verifique 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, _ismbbtrail_l para testar se o caractere multibyte está definido.

FIM do específico da página de código 932

Confira também

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