Classe CStringElementTraitsI

Essa classe fornece funções estáticas relacionadas a cadeias de caracteres armazenadas em objetos de classe de coleção. É semelhante a CStringElementTraits, mas executa comparações que não diferenciam maiúsculas e minúsculas.

Sintaxe

template <typename T, class CharTraits = CDefaultCharTraits<T ::XCHAR>>
class CStringElementTraitsI : public CElementTraitsBase<T>

Parâmetros

T
O tipo de dados a serem armazenados na coleção.

Membros

Typedefs públicos

Nome	Descrição
CStringElementTraitsI::INARGTYPE	O tipo de dados a ser usado para adicionar elementos ao objeto da classe de coleção.
CStringElementTraitsI::OUTARGTYPE	O tipo de dados a ser usado para recuperar elementos do objeto de classe de coleção.

Métodos públicos

Nome	Descrição
CStringElementTraitsI::CompareElements	Chame essa função estática para comparar dois elementos da cadeia de caracteres para igualdade, ignorando diferenças entre maiúsculas e minúsculas.
CStringElementTraitsI::CompareElementsOrdered	Chame essa função estática para comparar dois elementos da cadeia de caracteres, ignorando diferenças entre maiúsculas e minúsculas.
CStringElementTraitsI::Hash	Chame essa função estática para calcular um valor de hash para o elemento da cadeia de caracteres fornecido.

Comentários

Essa classe fornece funções estáticas para comparar cadeias de caracteres e para criar um valor de hash. Essas funções são úteis ao usar uma classe de coleção para armazenar dados baseados em cadeia de caracteres. Use CStringRefElementTraits quando os objetos de cadeia de caracteres devem ser tratados como referências.

Para obter mais informações, confira Classes de Coleção da ATL.

Hierarquia de herança

CElementTraitsBase

CStringElementTraitsI

Requisitos

Cabeçalho: atlcoll.h

CStringElementTraitsI::CompareElements

Chame essa função estática para comparar dois elementos da cadeia de caracteres para igualdade, ignorando diferenças entre maiúsculas e minúsculas.

static bool CompareElements(INARGTYPE str1, INARGTYPE str2) throw();

Parâmetros

str1
O primeiro elemento da cadeia de caracteres.

str2
O segundo elemento da cadeia de caracteres.

Valor de Devolução

Retorna true se os elementos forem iguais, false caso contrário.

Comentários

As comparações diferenciam maiúsculas e minúsculas.

CStringElementTraitsI::CompareElementsOrdered

Chame essa função estática para comparar dois elementos da cadeia de caracteres, ignorando diferenças entre maiúsculas e minúsculas.

static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2) throw();

Parâmetros

str1
O primeiro elemento da cadeia de caracteres.

str2
O segundo elemento da cadeia de caracteres.

Valor de Devolução

Zero se as cadeias de caracteres forem idênticas, < 0 se str1for menor do que str2, ou > 0 se str1 for maior do que str2. O método CStringT::Compare é usado para realizar as comparações.

Comentários

As comparações diferenciam maiúsculas e minúsculas.

CStringElementTraitsI::Hash

Chame essa função estática para calcular um valor de hash para o elemento da cadeia de caracteres fornecido.

static ULONG Hash(INARGTYPE str) throw();

Parâmetros

str
O elemento da cadeia de caracteres.

Valor de Devolução

Retorna um valor de hash, calculado usando o conteúdo da cadeia de caracteres.

CStringElementTraitsI::INARGTYPE

O tipo de dados a ser usado para adicionar elementos ao objeto da classe de coleção.

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

O tipo de dados a ser usado para recuperar elementos do objeto de classe de coleção.

typedef T& OUTARGTYPE;

Confira também

Classe CElementTraitsBase
Visão geral da classe
Classe CStringElementTraits