Поделиться через

Класс CMap

  • Статья

Класс коллекции словаря, который сопоставляет уникальные ключи в значения.

template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject

Параметры

  • KEY
    Класс объекта, используемого в качестве ключа для сопоставления.

  • ARG _ KEY
    Тип данных, используемый для аргументов KEY; обычно ссылка на KEY.

  • VALUE
    Класс объекта, хранящихся в сопоставлении.

  • ARG _ VALUE
    Тип данных, используемый для аргументов VALUE; обычно ссылка на VALUE.

Члены

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

Имя

Описание

CMap::CPair

Вложенная структура, содержащая значение ключа и значение связанного объекта.

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

Имя

Описание

CMap::CMap

Создает коллекцию, которая сопоставляет ключи в значения.

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

Имя

Описание

CMap::GetCount

Получает число элементов в данном сопоставлении.

CMap::GetHashTableSize

Возвращает количество элементов в хэш-таблице.

CMap::GetNextAssoc

Возвращает следующий элемент для итерации.

CMap::GetSize

Получает число элементов в данном сопоставлении.

CMap::GetStartPosition

Возвращает позицию первого элемента.

CMap::InitHashTable

Инициализирует хэш-таблицы и указывает его размер.

CMap::IsEmpty

Тесты для условия пуст- сопоставления (без элементов).

CMap::Lookup

Ищет значения, полученного в заданный ключ.

CMap::PGetFirstAssoc

Возвращает указатель на первый элемент.

CMap::PGetNextAssoc

Получает указатель на следующий элемент для итерации.

CMap::PLookup

Возвращает указатель к ключу, значение которого соответствует заданному значению.

CMap::RemoveAll

Удаляет все элементы из данного сопоставления.

CMap::RemoveKey

Удаляет элемент, заданный ключом.

CMap::SetAt

Вставляет элемент в сопоставление; заменяет существующий элемент, если соответствующий ключ поиска.

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

Имя

Описание

CMap::operator []

Вставляет элемент в сопоставление — подстановка оператора для SetAt.

Заметки

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

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

Некоторые функции-члены этого класса вызывают глобальные вспомогательные функции, необходимые для настройки для большинства польз класса CMap. См. раздел Вспомогательные объекты класса коллекции в разделе "Макросы и глобальные переменные MFCReference.

CMap переопределяет CObject::Serialize для поддержки сериализации и сбрасывать его элементов. Если сопоставление хранится в архив с помощью Serialize, то каждый элемент карты сериализации в свою очередь. Реализация по умолчанию вспомогательные функции SerializeElements выполняет битовую запись. Дополнительные сведения о сериализации элементов коллекции, производных от CObject или других пользовательских типов см. в разделе Практическое руководство. Создание типобезопасных коллекций.

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

Если объект CMap удаления или при его элементы удалены, ключи и значения обоих удалены.

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

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

CObject

CMap

Требования

Header: afxtempl.h

См. также

Ссылки

Класс CObject

Диаграмма иерархии

Основные понятия

Образец MFC СОБИРАЕТ