Partilhar via

Classe CStringElementTraitsI

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. É semelhante ao CStringElementTraits, mas realiza comparações insensíveis a maiúsculas minúsculas.

Sintaxe

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

Parâmetros

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

Membros

Definições de Tipos Públicas

Nome Description
CStringElementTraitsI::INARGTYPE O tipo de dados a usar para adicionar elementos ao objeto de classe de coleção.
CStringElementTraitsI::OUTARGTYPE O tipo de dado a usar para recuperar elementos do objeto de classe de coleção.

Métodos Públicos

Nome Description
CStringElementTraitsI::CompareElements Chame esta função estática para comparar dois elementos de cadeia para igualdade, ignorando as diferenças no caso.
CStringElementTraitsI::CompareElementsOrdered Chame esta função estática para comparar dois elementos de cadeia, ignorando as diferenças no caso.
CStringElementTraitsI::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. Use CStringRefElementTraits quando os objetos string forem tratados como referências.

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

Hierarquia de herança

CElementTraitsBase

CStringElementTraitsI

Requerimentos

Cabeçalho: atlcoll.h

CStringElementTraitsI::CompareElements

Chame esta função estática para comparar dois elementos de cadeia para igualdade, ignorando as diferenças no caso.

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

Parâmetros

str1
O primeiro elemento da corda.

str2
O segundo elemento de corda.

Valor de retorno

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

Observações

As comparações são indiferentes a maiúsculas e minúsculas.

CStringElementTraitsI::CompareElementsOrdered

Chame esta função estática para comparar dois elementos de cadeia, ignorando as diferenças no caso.

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.

Observações

As comparações são indiferentes a maiúsculas e minúsculas.

CStringElementTraitsI::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.

CStringElementTraitsI::INARGTYPE

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

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

O tipo de dado a usar para recuperar elementos do objeto de classe de coleção.

typedef T& OUTARGTYPE;

Consulte também

CElementTraitsClasse Base
Visão geral da classe
Classe CStringElementTraits

  • Last updated on