Класс CMapStringToOb

Статья
06/10/2015

Класс коллекции словаря, который сопоставляет уникальным CString возражает к указателям CObject.

class CMapStringToOb : public CObject

Члены

Открытые конструкторы

Имя	Описание
CMapStringToOb::CMapStringToOb	Конструктор.

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

Имя	Описание
CMapStringToOb::GetCount	Получает число элементов в данном сопоставлении.
CMapStringToOb::GetHashTableSize	Задает текущее количество элементов в хэш-таблице.
CMapStringToOb::GetNextAssoc	Возвращает следующий элемент для итерации.
CMapStringToOb::GetSize	Получает число элементов в данном сопоставлении.
CMapStringToOb::GetStartPosition	Возвращает позицию первого элемента.
CMapStringToOb::HashKey	Вычисляет хэш-значение заданного ключа.
CMapStringToOb::InitHashTable	Инициализирует хэш-таблицы.
CMapStringToOb::IsEmpty	Тесты для условия пуст- сопоставления (без элементов).
CMapStringToOb::Lookup	Ищет пустой указатель на основе пустом ключе индекса. Значение указателя, не оно указывает на сущность, используемый для сравнения ключей.
CMapStringToOb::LookupKey	Возвращает ссылку на ключ, связанный с указанным значением ключа.
CMapStringToOb::RemoveAll	Удаляет все элементы из данного сопоставления.
CMapStringToOb::RemoveKey	Удаляет элемент, заданный ключом.
CMapStringToOb::SetAt	Вставляет элемент в сопоставление; заменяет существующий элемент, если соответствующий ключ поиска.

Открытые операторы

Имя	Описание
CMapStringToOb::operator []	Вставляет элемент в сопоставление — подстановка оператора для SetAt.

Заметки

Как только вводили пару CString-CObject* (элемент) в сопоставление, можно эффективно извлекать или удаления пары с помощью строки или значение CString в качестве ключа. Кроме того, можно осуществить перебор всех элементов в сопоставлении.

Переменная типа POSITION используется для другого доступа записи из всех изменениях сопоставления. Можно использовать POSITION "вспоминаете" запись и перебора сопоставление. Можно представить, что эта итерация последовательная значение ключа. нет. Последовательность полученных элементов непредвиденна.

CMapStringToOb содержит макрос IMPLEMENT_SERIAL для поддержки сериализации и сбрасывать его элементов. Каждый элемент сериализации в свою очередь, если сопоставление хранится в архив или с перегруженным оператора insert (<<) или функцией-членом Serialize.

Если требуется диагностический дамп отдельных элементов в сопоставлении (значение CString и содержимое CObject ), необходимо задать глубину контекст дампа значение 1 или больше.

Если объект CMapStringToOb удаления или при его элементы удалены, удалены объекты CString и указатели CObject. Не уничтожены объекты, на которые ссылается CObject указателями.

Источник класса сопоставления похож на вывод списка. См. статью коллекции для иллюстрации вывода одноцелевого класса списка.