QMultiMap::key_iterator Class
class QMultiMap::key_iteratorQMultiMap::key_iterator 类为QMultiMap 键提供了STL风格的const迭代器。更多内容...
公共函数
| key_iterator() | |
| QMultiMap<Key, T>::const_iterator | base() const |
| bool | operator!=(QMultiMap<Key, T>::key_iterator other) const |
| const Key & | operator*() const |
| QMultiMap<Key, T>::key_iterator & | operator++() |
| QMultiMap<Key, T>::key_iterator | operator++(int) |
| QMultiMap<Key, T>::key_iterator & | operator--() |
| QMultiMap<Key, T>::key_iterator | operator--(int) |
| const Key * | operator->() const |
| bool | operator==(QMultiMap<Key, T>::key_iterator other) const |
详细说明
QMultiMap::key_iterator 本质上与 `QMultiMap::const_iterator ` 相同，区别在于 `operator*()` 和 `operator->()` 返回的是键而非值。
在大多数情况下，应使用 `QMultiMap::iterator ` 和 `QMultiMap::const_iterator `；您可以通过调用 `QMultiMap::iterator::key()` 轻松获取键：
for (auto it = multimap.cbegin(), end = multimap.cend(); it != end; ++it) {
cout << "The key: " << it.key() << endl;
cout << "The value: " << qPrintable(it.value()) << endl;
cout << "Also the value: " << qPrintable(*it) << endl;
}然而，为了实现QMultiMap 的键与STL风格算法的互操作性，我们需要一个解引用后返回键而非值的迭代器。通过QMultiMap::key_iterator ，我们可以对一组键应用算法，而无需调用QMultiMap::keys()——后者效率较低，因为它需要进行一次QMultiMap 迭代，并为创建临时QList 对象分配内存。
// 低效，keys() 调用开销大
QList<int>keys=multimap.keys();
intnumPrimes=std::count_if(multimap.cbegin(),multimap.cend(),isPrimeNumber);
qDeleteAll(multimap2.keys());
// 高效，无需内存分配
intprimeNums=std::count_if(multimap.keyBegin(),multimap.keyEnd(),isPrimeNumber);
qDeleteAll(multimap2.keyBegin(), multimap2.keyEnd());QMultiMap::key_iterator 如果为 const，则无法修改键。
默认的QMultiMap::key_iterator 构造函数会创建一个未初始化的迭代器。您必须使用QMultiMap 函数（如QMultiMap::keyBegin()或QMultiMap::keyEnd()）对其进行初始化。
警告： 隐式共享容器上的迭代器其 行为与 STL 迭代器并不完全一致。当迭代器在容器上处于活动状态时，应避免复制该容器。有关更多信息，请参阅“隐式共享迭代器问题”。
另请参阅 QMultiMap::const_iterator 和QMultiMap::iterator 。
成员函数文档
[default] key_iterator::key_iterator()
默认——构造一个key_iterator 的实例。
QMultiMap<Key, T>::const_iterator key_iterator::base() const
返回该 `key_iterator ` 所基于的底层 `const_iterator `。
bool key_iterator::operator!=(QMultiMap<Key, T>::key_iterator other) const
如果 `other ` 指向的对象与该迭代器指向的对象不同，则返回 `true `；否则返回 `false`。
另请参阅 operator==()。
const Key &key_iterator::operator*() const
返回当前项的键。
QMultiMap<Key, T>::key_iterator &key_iterator::operator++()
前缀运算符++ （++i ）将迭代器向前移动到哈希表中的下一个项目，并返回指向新当前项目的迭代器。
在 `QMultiMap::keyEnd()` 上调用此函数将导致未定义的结果。
另请参阅 operator--()。
QMultiMap<Key, T>::key_iterator key_iterator::operator++(int)
后缀运算符++ （i++ ）将迭代器向前移动到哈希表中的下一个元素，并返回指向前一个元素的迭代器。
这是一个重载函数。
QMultiMap<Key, T>::key_iterator &key_iterator::operator--()
前缀-- 运算符（--i ）将前一个元素设为当前元素，并返回一个指向新当前元素的迭代器。
在 `QMultiMap::keyBegin()` 上调用此函数将导致未定义的结果。
另请参阅 operator++()。
QMultiMap<Key, T>::key_iterator key_iterator::operator--(int)
后缀运算符-- （i-- ）将前一个元素设为当前元素，并返回一个指向前一个元素的迭代器。
这是一个重载函数。
const Key *key_iterator::operator->() const
返回指向当前项键的指针。
bool key_iterator::operator==(QMultiMap<Key, T>::key_iterator other) const
如果 `other ` 指向与该迭代器相同的项，则返回 `true `；否则返回 `false`。
另请参阅 operator!=()。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
