Condividi tramite


Classe CStringElementTraitsI

Questa classe fornisce funzioni statiche correlate alle stringhe archiviate negli oggetti classe di raccolta. È simile a CStringElementTraits, ma esegue confronti senza distinzione tra maiuscole e minuscole.

Sintassi

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

Parametri

T
Tipo di dati da archiviare nella raccolta.

Membri

Typedef pubblici

Nome Descrizione
CStringElementTraitsI::INARGTYPE Tipo di dati da utilizzare per l'aggiunta di elementi all'oggetto classe di raccolta.
CStringElementTraitsI::OUTARGTYPE Tipo di dati da utilizzare per il recupero di elementi dall'oggetto classe di raccolta.

Metodi pubblici

Nome Descrizione
CStringElementTraitsI::CompareElements Chiamare questa funzione statica per confrontare due elementi stringa per verificarne l'uguaglianza, ignorando le differenze nel caso.
CStringElementTraitsI::CompareElementsOrdered Chiamare questa funzione statica per confrontare due elementi stringa, ignorando le differenze nel caso.
CStringElementTraitsI::Hash Chiamare questa funzione statica per calcolare un valore hash per l'elemento stringa specificato.

Osservazioni:

Questa classe fornisce funzioni statiche per confrontare le stringhe e per la creazione di un valore hash. Queste funzioni sono utili quando si usa una classe di raccolta per archiviare dati basati su stringhe. Usare CStringRefElementTraits quando gli oggetti stringa devono essere gestiti come riferimenti.

Per altre informazioni, vedere Classi di raccolta ATL.

Gerarchia di ereditarietà

CElementTraitsBase

CStringElementTraitsI

Requisiti

Intestazione: atlcoll.h

CStringElementTraitsI::CompareElements

Chiamare questa funzione statica per confrontare due elementi stringa per verificarne l'uguaglianza, ignorando le differenze nel caso.

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

Parametri

str1
Primo elemento stringa.

str2
Secondo elemento stringa.

Valore restituito

Restituisce true se gli elementi sono uguali, false in caso contrario.

Osservazioni:

I confronti non fanno distinzione tra maiuscole e minuscole.

CStringElementTraitsI::CompareElementsOrdered

Chiamare questa funzione statica per confrontare due elementi stringa, ignorando le differenze nel caso.

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

Parametri

str1
Primo elemento stringa.

str2
Secondo elemento stringa.

Valore restituito

Zero se le stringhe sono identiche, < 0 se str1 è minore di str2 o > 0 se str1 è maggiore di str2. Il metodo CStringT::Compare viene usato per eseguire i confronti.

Osservazioni:

I confronti non fanno distinzione tra maiuscole e minuscole.

CStringElementTraitsI::Hash

Chiamare questa funzione statica per calcolare un valore hash per l'elemento stringa specificato.

static ULONG Hash(INARGTYPE str) throw();

Parametri

str
Elemento stringa.

Valore restituito

Restituisce un valore hash, calcolato utilizzando il contenuto della stringa.

CStringElementTraitsI::INARGTYPE

Tipo di dati da utilizzare per l'aggiunta di elementi all'oggetto classe di raccolta.

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

Tipo di dati da utilizzare per il recupero di elementi dall'oggetto classe di raccolta.

typedef T& OUTARGTYPE;

Vedi anche

Classe CElementTraitsBase
Cenni preliminari sulla classe
Classe CStringElementTraits