Udostępnij za pośrednictwem


Klasa CStringElementTraitsI

Ta klasa udostępnia funkcje statyczne związane z ciągami przechowywanymi w obiektach klasy kolekcji. Jest on podobny do CStringElementTraits, ale wykonuje porównania bez uwzględniania wielkości liter.

Składnia

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

Parametry

T
Typ danych, które mają być przechowywane w kolekcji.

Członkowie

Definicje typów publicznych

Nazwa/nazwisko opis
CStringElementTraitsI::INARGTYPE Typ danych używany do dodawania elementów do obiektu klasy kolekcji.
CStringElementTraitsI::OUTARGTYPE Typ danych używany do pobierania elementów z obiektu klasy kolekcji.

Metody publiczne

Nazwa/nazwisko opis
CStringElementTraitsI::CompareElements Wywołaj tę funkcję statyczną, aby porównać dwa elementy ciągu pod kątem równości, ignorując różnice w przypadku.
CStringElementTraitsI::CompareElementsOrdered Wywołaj tę funkcję statyczną, aby porównać dwa elementy ciągu, ignorując różnice w przypadku.
CStringElementTraitsI::Hash Wywołaj tę funkcję statyczną, aby obliczyć wartość skrótu dla danego elementu ciągu.

Uwagi

Ta klasa udostępnia funkcje statyczne do porównywania ciągów i tworzenia wartości skrótu. Te funkcje są przydatne podczas używania klasy kolekcji do przechowywania danych opartych na ciągach. Użyj CStringRefElementTraits , gdy obiekty ciągu mają być traktowane jako odwołania.

Aby uzyskać więcej informacji, zobacz Klasy kolekcji ATL.

Hierarchia dziedziczenia

CElementTraitsBase

CStringElementTraitsI

Wymagania

Nagłówek: atlcoll.h

CStringElementTraitsI::CompareElements

Wywołaj tę funkcję statyczną, aby porównać dwa elementy ciągu pod kątem równości, ignorując różnice w przypadku.

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

Parametry

str1
Pierwszy element ciągu.

str2
Drugi element ciągu.

Wartość zwracana

Zwraca wartość true, jeśli elementy są równe, w przeciwnym razie wartość false.

Uwagi

Porównania są niewrażliwe na wielkość liter.

CStringElementTraitsI::CompareElementsOrdered

Wywołaj tę funkcję statyczną, aby porównać dwa elementy ciągu, ignorując różnice w przypadku.

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

Parametry

str1
Pierwszy element ciągu.

str2
Drugi element ciągu.

Wartość zwracana

Zero, jeśli ciągi są identyczne, 0, jeśli str1 jest mniejszy niż str2, lub > 0, jeśli str1 jest większy niż str2.< Metoda CStringT::Compare służy do przeprowadzania porównań.

Uwagi

Porównania są niewrażliwe na wielkość liter.

CStringElementTraitsI::Hash

Wywołaj tę funkcję statyczną, aby obliczyć wartość skrótu dla danego elementu ciągu.

static ULONG Hash(INARGTYPE str) throw();

Parametry

Str
Element string.

Wartość zwracana

Zwraca wartość skrótu obliczaną przy użyciu zawartości ciągu.

CStringElementTraitsI::INARGTYPE

Typ danych używany do dodawania elementów do obiektu klasy kolekcji.

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

Typ danych używany do pobierania elementów z obiektu klasy kolekcji.

typedef T& OUTARGTYPE;

Zobacz też

Klasa CElementTraitsBase
Omówienie klasy
Klasa CStringElementTraits