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
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 retorno
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 retorno
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 retorno
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 aula
Classe CStringElementTraits