Класс key_iterator

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

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

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

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

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

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

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

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

Однако, для обеспечения совместимости с алгоритмами в стиле STL ключи QHash требуют итератор, возвращающий ключ вместо значения. С помощью QHash::key_iterator можно применять алгоритм к диапазону ключей, не прибегая к вызову QHash::keys(), что менее эффективно, так как требует одну итерацию по QHash и выделение памяти для временного 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());

QHash::key_iterator является константным, изменение ключа невозможно.

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

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

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

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

key_iterator::key_iterator()

Создаёт экземпляр key_iterator по умолчанию.

key_iterator::key_iterator(const_iterator o)

Создаёт экземпляр key_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) перемещает итератор к следующему элементу в хеше и возвращает итератор на новый текущий элемент.

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

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

key_iterator key_iterator::operator++(int)

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

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

key_iterator &key_iterator::operator--()

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

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