QMultiMap::iterator Class
class QMultiMap::iteratorQMultiMap::iterator 类为QMultiMap 提供了STL风格的非const迭代器。更多内容...
公共类型
公共函数
| iterator() | |
| const Key & | key() const |
| T & | value() const |
| T & | operator*() const |
| QMultiMap<Key, T>::iterator & | operator++() |
| QMultiMap<Key, T>::iterator | operator++(int) |
| QMultiMap<Key, T>::iterator & | operator--() |
| QMultiMap<Key, T>::iterator | operator--(int) |
| T * | operator->() const |
相关的非成员
| bool | operator!=(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs) |
| bool | operator==(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs) |
详细说明
QMultiMap<Key, T>::iterator 允许您遍历QMultiMap ,并修改存储在特定键下的值(但不能修改键)。 若要遍历 constQMultiMap ,应使用QMultiMap::const_iterator 。通常,即使对于非 constQMultiMap ,也建议使用QMultiMap::const_iterator ,除非您需要通过迭代器修改QMultiMap 。常量迭代器速度稍快,且能提高代码可读性。
默认的QMultiMap::iterator 构造函数会创建一个未初始化的迭代器。在开始迭代之前,你必须使用QMultiMap 函数(如QMultiMap::begin()、QMultiMap::end() 或QMultiMap::find())对其进行初始化。以下是一个典型的循环,用于打印映射中存储的所有 (key, value) 对:
与将项目以任意顺序存储的QMultiHash 不同,QMultiMap 会按键值顺序存储项目。具有相同键值的项目将连续出现,从最近插入的值到最早插入的值依次排列。
以下是一个示例,它将QMultiMap 中存储的每个值加2:
for (auto i = multimap.begin(), end = multimap.end(); i != end; ++i)
i.value() += 2;要从QMultiMap 中移除元素,可以使用erase_if (QMultiMap<Key, T> &map, Predicate pred):
同一个xml-ph-0000@deepl.internal上可以使用多个迭代器。如果向xml-ph-0000@deepl.internal中添加元素,现有的迭代器仍然有效。如果从xml-ph-0000@deepl.internal中移除元素,指向已移除元素的迭代器将变成悬空迭代器。
警告: 隐式共享容器上的迭代器其 行为并不完全等同于 STL 迭代器。当迭代器在容器上处于活动状态时,应避免复制该容器。更多信息请参阅《隐式共享迭代器问题》。
另请参阅 QMultiMap::const_iterator 、QMultiMap::key_iterator 以及QMultiMap::key_value_iterator 。
成员函数文档
[default] iterator::iterator()
构建一个未初始化的迭代器。
不得对未初始化的迭代器调用诸如key()、value() 和 operator++() 等函数。在使用前,请使用 operator=() 向其赋值。
另请参阅 QMultiMap::begin() 和QMultiMap::end()。
const Key &iterator::key() const
返回当前项的键作为 const 引用。
虽然无法通过迭代器直接更改项的键,但可以通过先调用 `QMultiMap::erase()`,再调用 `QMultiMap::insert()` 来实现。
另请参阅 value()。
T &iterator::value() const
返回指向当前项值的可修改引用。
您可以在赋值语句的左侧使用 value() 来更改项的值,例如:
if (i.key() == "Hello")
i.value() = "Bonjour";T &iterator::operator*() const
返回指向当前项值的可修改引用。
与 `value()` 相同。
另请参阅 key()。
QMultiMap<Key, T>::iterator &iterator::operator++()
前缀运算符++ (++i )将迭代器向前移动到多映射中的下一个项,并返回指向新当前项的迭代器。
在 `QMultiMap::end()` 上调用此函数将导致未定义的结果。
另请参阅 operator--()。
QMultiMap<Key, T>::iterator iterator::operator++(int)
后缀运算符++ (i++ )将迭代器向前移动到多映射中的下一个项,并返回指向先前当前项的迭代器。
这是一个重载函数。
QMultiMap<Key, T>::iterator &iterator::operator--()
前缀运算符-- (--i )将前一个元素设为当前元素,并返回一个指向新当前元素的迭代器。
在 `QMultiMap::begin()` 上调用此函数将导致未定义的结果。
另请参阅 operator++()。
QMultiMap<Key, T>::iterator iterator::operator--(int)
后缀运算符-- (i-- )将前一个元素设为当前元素,并返回一个指向先前当前元素的迭代器。
这是一个重载函数。
T *iterator::operator->() const
返回指向当前项目值的指针。
另请参阅 value()。
相关的非成员
bool operator!=(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs)
如果 `lhs ` 指向的对象与 `rhs ` 迭代器指向的对象不同,则返回 `true `;否则返回 `false`。
另请参阅 operator==()。
bool operator==(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs)
如果 `lhs ` 指向与 `rhs ` 迭代器相同的项,则返回 `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.