Класс CStringElementTraitsI

Замечание

Библиотека активных шаблонов (ATL) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Этот класс предоставляет статические функции, связанные со строками, хранящимися в объектах класса коллекции. Он похож на CStringElementTraits, но выполняет сравнения без учета регистра.

Синтаксис

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

Параметры

T
Тип данных, хранящихся в коллекции.

Участники

Общедоступные определения типов

Имя	Описание
CStringElementTraitsI::INARGTYPE	Тип данных, используемый для добавления элементов в объект класса коллекции.
CStringElementTraitsI::OUTARGTYPE	Тип данных, используемый для извлечения элементов из объекта класса коллекции.

Открытые методы

Имя	Описание
CStringElementTraitsI::CompareElements	Вызовите эту статическую функцию, чтобы сравнить два строковых элемента для равенства, игнорируя различия в случае.
CStringElementTraitsI::CompareElementsOrdered	Вызовите эту статическую функцию для сравнения двух строковых элементов, игнорируя различия в случае.
CStringElementTraitsI::Hash	Вызовите эту статическую функцию, чтобы вычислить хэш-значение для заданного строкового элемента.

Замечания

Этот класс предоставляет статические функции для сравнения строк и создания хэш-значения. Эти функции полезны при использовании класса коллекции для хранения строковых данных. Используйте CStringRefElementTraits , когда строковые объекты должны рассматриваться как ссылки.

Дополнительные сведения см. в разделе "Классы коллекций ATL".

Иерархия наследования

CElementTraitsBase

CStringElementTraitsI

Требования

Заголовок: atlcoll.h

CStringElementTraitsI::CompareElements

Вызовите эту статическую функцию, чтобы сравнить два строковых элемента для равенства, игнорируя различия в случае.

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

Параметры

str1
Первый строковый элемент.

str2
Второй строковый элемент.

Возвращаемое значение

Возвращает значение true, если элементы равны, значение false в противном случае.

Замечания

Сравнения являются нечувствительными к регистру.

CStringElementTraitsI::CompareElementsOrdered

Вызовите эту статическую функцию для сравнения двух строковых элементов, игнорируя различия в случае.

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

Параметры

str1
Первый строковый элемент.

str2
Второй строковый элемент.

Возвращаемое значение

Ноль, если строки идентичны, 0, < если str1 меньше str2 или 0, если str1> больше str2. Метод CStringT::Compare используется для сравнения.

Замечания

Сравнения являются нечувствительными к регистру.

CStringElementTraitsI::Hash

Вызовите эту статическую функцию, чтобы вычислить хэш-значение для заданного строкового элемента.

static ULONG Hash(INARGTYPE str) throw();

Параметры

str
Строковый элемент.

Возвращаемое значение

Возвращает хэш-значение, вычисляемое с помощью содержимого строки.

CStringElementTraitsI::INARGTYPE

Тип данных, используемый для добавления элементов в объект класса коллекции.

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

Тип данных, используемый для извлечения элементов из объекта класса коллекции.

typedef T& OUTARGTYPE;

См. также

Класс CElementTraitsBase
Общие сведения о классе
Класс CStringElementTraits