Compartilhar via


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

CElementTraitsBase

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.

Confira também

Classe CElementTraitsBase
Visão geral da aula