Classe CStringRefElementTraits
Essa classe fornece funções estáticas relacionadas a cadeias de caracteres armazenadas em objetos de classe de coleção. Os objetos de cadeia de caracteres são tratados como referências.
Sintaxe
template <typename T>
class CStringRefElementTraits : public CElementTraitsBase<T>
Parâmetros
T
O tipo de dados a serem armazenados na coleção.
Membros
Métodos públicos
| Nome | Descrição |
|---|---|
| CStringRefElementTraits::CompareElements | Chame essa função estática para comparar dois elementos da cadeia de caracteres para igualdade. |
| CStringRefElementTraits::CompareElementsOrdered | Chame essa função estática para comparar dois elementos da cadeia de caracteres. |
| CStringRefElementTraits::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. Ao contrário de CStringElementTraits e CStringElementTraitsI, CStringRefElementTraits faz com que os CString argumentos sejam passados como const CString& referências.
Para obter mais informações, confira Classes de Coleção da ATL.
Hierarquia de herança
CStringRefElementTraits
Requisitos
Cabeçalho: atlcoll.h
CStringRefElementTraits::CompareElements
Chame essa função estática para comparar dois elementos da cadeia de caracteres para igualdade.
static bool CompareElements(INARGTYPE element1, INARGTYPE element2) throw();
Parâmetros
element1
O primeiro elemento da cadeia de caracteres.
element2
O segundo elemento da cadeia de caracteres.
Valor de retorno
Retorna true se os elementos forem iguais, false caso contrário.
CStringRefElementTraits::CompareElementsOrdered
Chame essa função estática para comparar dois elementos da cadeia de caracteres.
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.
CStringRefElementTraits::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.