Partilhar via

Classe CStringRefElementTraits

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe fornece funções estáticas relacionadas com strings armazenadas nos objetos da classe de coleção. Os objetos string são tratados como referências.

Sintaxe

template <typename T>
class CStringRefElementTraits : public CElementTraitsBase<T>

Parâmetros

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

Membros

Métodos Públicos

Nome Description
CStringRefElementTraits::CompareElements Chama esta função estática para comparar dois elementos de cadeia para igualdade.
CStringRefElementTraits::CompareElementsOrdered Chame esta função estática para comparar dois elementos de corda.
CStringRefElementTraits::Hash Chame esta função estática para calcular um valor de hash para o elemento da cadeia dado.

Observações

Esta classe fornece funções estáticas para comparar strings e para criar um valor de hash. Estas funções são úteis quando se utiliza uma classe de coleção para armazenar dados baseados em strings. Ao contrário de CStringElementTraits e CStringElementTraitsI, CStringRefElementTraits faz com que os CString argumentos sejam passados como constCString& referências.

Para mais informações, consulte Aulas de Coleção ATL.

Hierarquia de herança

CElementTraitsBase

CStringRefElementTraits

Requerimentos

Cabeçalho: atlcoll.h

CStringRefElementTraits::CompareElements

Chama esta função estática para comparar dois elementos de cadeia para igualdade.

static bool CompareElements(INARGTYPE element1, INARGTYPE element2) throw();

Parâmetros

elemento1
O primeiro elemento da corda.

element2
O segundo elemento de corda.

Valor de retorno

Retorna verdadeiro se os elementos forem iguais, falso caso contrário.

CStringRefElementTraits::CompareElementsOrdered

Chame esta função estática para comparar dois elementos de corda.

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

Parâmetros

str1
O primeiro elemento da corda.

str2
O segundo elemento de corda.

Valor de retorno

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

CStringRefElementTraits::Hash

Chame esta função estática para calcular um valor de hash para o elemento da cadeia dado.

static ULONG Hash(INARGTYPE str) throw();

Parâmetros

STR
O elemento da corda.

Valor de retorno

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

Consulte também

CElementTraitsClasse Base
Visão geral da classe

  • Last updated on