Класс key_iterator

Класс QMultiMap::key_iterator предоставляет итератор в стиле STL для константных ключей QMultiMap. Подробнее...

Этот класс был представлен в Qt 5.6.

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

QMultiMap::key_iterator по сути, идентичен QMultiMap::const_iterator с той разницей, что операторы operator*() и operator->() возвращают ключ вместо значения.

Для большинства задач следует использовать QMultiMap::iterator и QMultiMap::const_iterator, вы можете легко получить доступ к ключу, вызвав QMultiMap::iterator::key():

for (QMultiMap<int, QString>::const_iterator it = multimap.cbegin(), end = multimap.cend(); it != end; ++it) {
    cout << "The key: " << it.key() << Qt::endl
    cout << "The value: " << it.value() << Qt::endl;
    cout << "Also the value: " << (*it) << Qt::endl;
}

Однако, для обеспечения совместимости между ключами QMultiMap и алгоритмами в стиле STL, нам нужен итератор, который обращается к ключу вместо значения. С помощью QMultiMap::key_iterator можно применить алгоритм к диапазону ключей без необходимости вызова QMultiMap::keys(), что является неэффективным, так как это требует одной итерации по QMultiMap и выделения памяти для создания временного QList.

// Inefficient, keys() is expensive
QList<int> keys = multimap.keys();
int numPrimes = std::count_if(multimap.cbegin(), multimap.cend(), isPrimeNumber);
qDeleteAll(multimap2.keys());

// Efficient, no memory allocation needed
int numPrimes = std::count_if(multimap.keyBegin(), multimap.keyEnd(), isPrimeNumber);
qDeleteAll(multimap2.keyBegin(), multimap2.keyEnd());

QMultiMap::key_iterator является константным, поэтому изменить ключ нельзя.

Конструктор по умолчанию QMultiMap::key_iterator создает неинициализированный итератор. Необходимо инициализировать его с помощью функции QMultiMap, например, QMultiMap::keyBegin() или QMultiMap::keyEnd().

См. также QMultiMap::const_iterator и QMultiMap::iterator.

Документация по функциям-членам

const_iterator key_iterator::base() const

Возвращает базовый const_iterator, на котором основан данный key_iterator.

bool key_iterator::operator!=(key_iterator other) const

Возвращает true если other указывает на другой элемент, чем этот итератор; в противном случае возвращает false.

См. также operator==().

const Key &key_iterator::operator*() const

Возвращает ключ текущего элемента.

key_iterator &key_iterator::operator++()

Префиксный оператор ++ (++i) перемещает итератор к следующему элементу в хэше и возвращает итератор на новый текущий элемент.

Вызов этой функции для QMultiMap::keyEnd() приводит к неопределённым результатам.

См. также operator--().

key_iterator key_iterator::operator++(int)

Это перегруженная функция.

Постфиксный оператор ++ (i++) перемещает итератор к следующему элементу в хэше и возвращает итератор на предыдущий элемент.

key_iterator &key_iterator::operator--()

Префиксный оператор -- (--i) устанавливает предыдущий элемент как текущий и возвращает итератор, указывающий на новый текущий элемент.

Вызов этой функции для QMultiMap::keyBegin() приводит к неопределённым результатам.

См. также operator++().

key_iterator key_iterator::operator--(int)

Это перегруженная функция.

Постфиксный оператор -- (i--) устанавливает предыдущий элемент как текущий и возвращает итератор, указывающий на предыдущий элемент.

const Key *key_iterator::operator->() const

Возвращает указатель на ключ текущего элемента.

bool key_iterator::operator==(key_iterator other) const

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

См. также operator!=().