Класс key_iterator

Класс QMap::key_iterator предоставляет итератор в стиле STL для константного доступа к ключам QMap и QMultiMap. Подробнее...

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

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

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

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

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

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

for (QMap<int, QString>::const_iterator it = map.cbegin(), end = map.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;
}

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

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

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

QMap::key_iterator является константным, модифицировать ключ не представляется возможным.

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

Предупреждение: Итераторы неявно-разделяемых контейнеров работают не совсем как итераторы STL. Следует избегать копирования контейнера во время работы с итераторами этого контейнера. Более подробную информацию см. в разделе Проблема итераторов при неявном совместном использовании.

См. также QMap::const_iterator и QMap::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) переводит итератор к следующему элементу в хеш-таблице и возвращает итератор на новый текущий элемент.

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

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

key_iterator key_iterator::operator++(int)

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

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

key_iterator &key_iterator::operator--()

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

Вызов этой функции для QMap::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!=().