Compartilhar via


ctype::is

Testa se um único caractere tem um atributo específico ou classifica os atributos de cada caractere em um intervalo e armazená-los em uma matriz.

bool is(
    mask maskVal, 
    CharType ch
) const;
const CharType *is(
    const CharType* first, 
    const CharType* last,
    mask* dest
) const;

Parâmetros

  • maskVal
    O valor da máscara para o caractere deve ser testada.

  • ch
    O caractere cujos atributos devem ser testadas.

  • first
    Um ponteiro para o primeiro caractere no intervalo cujos atributos devem ser classificada.

  • last
    Um ponteiro para o caractere imediatamente depois do último caractere no intervalo cujos atributos devem ser classificada.

  • dest
    Um ponteiro para o início da matriz onde a máscara avalia caracterizar os atributos de cada um dos caracteres deve ser armazenado.

Valor de retorno

A primeira função de membro retorna true se o caractere testado tem o atributo descrito pelo valor da máscara; false se não tiver o atributo.

A segunda função de membro retorna um ponteiro para o último caractere no intervalo cujos atributos devem ser classificada.

Comentários

A máscara avalia classificar os atributos de caracteres é fornecida pela classe classe de ctype_base, que o C se deriva. A primeira função de membro pode aceitar expressões para o primeiro parâmetro chamado máscaras de bits e formado da combinação de valores de máscara pelos operadores bit a bit (lógicos| & , ^, ~).

Exemplo

// ctype_is.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main() {
   locale loc1 ( "German_Germany" ), loc2 ( "English_Australia" );

   if (use_facet<ctype<char> > ( loc1 ).is( ctype_base::alpha, 'a' ))
      cout << "The character 'a' in locale loc1 is alphabetic." 
           << endl;
   else
      cout << "The character 'a' in locale loc1 is not alphabetic." 
           << endl;

   if (use_facet<ctype<char> > ( loc2 ).is( ctype_base::alpha, '!' ))
      cout << "The character '!' in locale loc2 is alphabetic." 
           << endl;
   else
      cout << "The character '!' in locale loc2 is not alphabetic." 
           << endl;

   char *string = "Hello, my name is John!";
   ctype<char>::mask maskarray[30];
   use_facet<ctype<char> > ( loc2 ).is(
      string, string + strlen(string), maskarray );
   for (unsigned int i = 0; i < strlen(string); i++) {
      cout << string[i] << ": "
           << (maskarray[i] & ctype_base::alpha ? "alpha"
                                                : "not alpha")
           << endl;;
   };
}

Saída

The character 'a' in locale loc1 is alphabetic.
The character '!' in locale loc2 is not alphabetic.
H: alpha
e: alpha
l: alpha
l: alpha
o: alpha
,: not alpha
 : not alpha
m: alpha
y: alpha
 : not alpha
n: alpha
a: alpha
m: alpha
e: alpha
 : not alpha
i: alpha
s: alpha
 : not alpha
J: alpha
o: alpha
h: alpha
n: alpha
!: not alpha

Requisitos

localidade <deCabeçalho: >

Namespace: std

Consulte também

Referência

Classe ctype