CStringElementTraitsI-Klasse

Diese Klasse stellt statische Funktionen im Zusammenhang mit Zeichenfolgen bereit, die in Auflistungsklassenobjekten gespeichert sind. Es ähnelt CStringElementTraits, führt jedoch Vergleiche zwischen Groß- und Kleinschreibung durch.

Syntax

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

Parameter

T
Der Datentyp, der in der Sammlung gespeichert werden soll.

Member

Öffentliche Typedefs

Name	Beschreibung
CStringElementTraitsi::INARGTYPE	Der Datentyp, der zum Hinzufügen von Elementen zum Auflistungsklassenobjekt verwendet werden soll.
CStringElementTraitsI::OUTARGTYPE	Der Datentyp, der zum Abrufen von Elementen aus dem Auflistungsklassenobjekt verwendet werden soll.

Öffentliche Methoden

Name	Beschreibung
CStringElementTraitsI::CompareElements	Rufen Sie diese statische Funktion auf, um zwei Zeichenfolgenelemente für Gleichheit zu vergleichen, wobei Unterschiede im Fall ignoriert werden.
CStringElementTraitsI::CompareElementsOrdered	Rufen Sie diese statische Funktion auf, um zwei Zeichenfolgenelemente zu vergleichen, wobei Unterschiede im Fall ignoriert werden.
CStringElementTraitsI::Hash	Rufen Sie diese statische Funktion auf, um einen Hashwert für das angegebene Zeichenfolgenelement zu berechnen.

Hinweise

Diese Klasse stellt statische Funktionen zum Vergleichen von Zeichenfolgen und zum Erstellen eines Hashwerts bereit. Diese Funktionen sind nützlich, wenn Sie eine Sammlungsklasse zum Speichern von zeichenfolgenbasierten Daten verwenden. Verwenden Sie CStringRefElementTraits , wenn die Zeichenfolgenobjekte als Verweise behandelt werden sollen.

Weitere Informationen finden Sie unter ATL-Auflistungsklassen.

Vererbungshierarchie

CElementTraitsBase

CStringElementTraitsI

Anforderungen

Kopfzeile: atlcoll.h

CStringElementTraitsI::CompareElements

Rufen Sie diese statische Funktion auf, um zwei Zeichenfolgenelemente für Gleichheit zu vergleichen, wobei Unterschiede im Fall ignoriert werden.

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

Parameter

str1
Das erste Zeichenfolgenelement.

str2
Das zweite Zeichenfolgenelement.

Rückgabewert

Gibt true zurück, wenn die Elemente gleich sind, andernfalls "false".

Hinweise

Bei Vergleichen wird die Groß-/Kleinschreibung nicht beachtet.

CStringElementTraitsI::CompareElementsOrdered

Rufen Sie diese statische Funktion auf, um zwei Zeichenfolgenelemente zu vergleichen, wobei Unterschiede im Fall ignoriert werden.

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

Parameter

str1
Das erste Zeichenfolgenelement.

str2
Das zweite Zeichenfolgenelement.

Rückgabewert

Null, wenn die Zeichenfolgen identisch sind, < 0, wenn str1 kleiner als str2 ist, oder > 0, wenn str1 größer als str2 ist. Die CStringT::Compare-Methode wird verwendet, um die Vergleiche auszuführen.

Hinweise

Bei Vergleichen wird die Groß-/Kleinschreibung nicht beachtet.

CStringElementTraitsI::Hash

Rufen Sie diese statische Funktion auf, um einen Hashwert für das angegebene Zeichenfolgenelement zu berechnen.

static ULONG Hash(INARGTYPE str) throw();

Parameter

str
Das Zeichenfolgenelement.

Rückgabewert

Gibt einen Hashwert zurück, der mithilfe des Inhalts der Zeichenfolge berechnet wird.

CStringElementTraitsi::INARGTYPE

Der Datentyp, der zum Hinzufügen von Elementen zum Auflistungsklassenobjekt verwendet werden soll.

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

Der Datentyp, der zum Abrufen von Elementen aus dem Auflistungsklassenobjekt verwendet werden soll.

typedef T& OUTARGTYPE;

Siehe auch

CElementTraitsBase-Klasse
Klassenübersicht
CStringElementTraits-Klasse