Класс key_iterator

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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!=().