Back to Qt.io
Contact Us Blog Download Qt
本页内容

QCborMap::ConstIterator Class

class QCborMap::ConstIterator

QCborMap::ConstIterator 类为QCborMap 提供了STL风格的const迭代器。更多内容...

QCborMap::ConstIterator 比较

类别可比较类型
strongQCborMap::ConstIterator
strongIterator.

公共类型

iterator_category

公共函数

ConstIterator()
ConstIterator(const QCborMap::ConstIterator &other)
~ConstIterator()
QCborValue key() const
QCborValueConstRef value() const
QCborMap::ConstIterator::value_type operator*() const
QCborMap::ConstIterator operator+(qsizetype j) const
QCborMap::ConstIterator &operator++()
QCborMap::ConstIterator operator++(int)
QCborMap::ConstIterator &operator+=(qsizetype j)
qsizetype operator-(QCborMap::ConstIterator j) const
QCborMap::ConstIterator operator-(qsizetype j) const
QCborMap::ConstIterator &operator--()
QCborMap::ConstIterator operator--(int)
QCborMap::ConstIterator &operator-=(qsizetype j)
const QCborValueConstRef *operator->() const
QCborMap::ConstIterator &operator=(const QCborMap::ConstIterator &other)
bool operator!=(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator<(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator<=(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator==(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator>(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)
bool operator>=(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

详细说明

QCborMap::ConstIterator 允许您遍历QCborMap 。如果您希望在遍历过程中修改QCborMap ，则必须改用QCborMap::Iterator 。通常，即使面对非const类型的QCborMap ，只要您无需通过迭代器更改QCborMap ，也建议使用QCborMap::ConstIterator 。const迭代器速度稍快，且能提高代码可读性。

在开始迭代之前，必须使用QCborMap 函数（如QCborMap::begin()、QCborMap::end() 或QCborMap::find()）对迭代器进行初始化。

同一个对象上可以使用多个迭代器。但如果对象被修改，现有的迭代器将变为悬空迭代器。

另请参阅 QCborMap::Iterator 。

成员类型文档

ConstIterator::iterator_category

std::random_access_iterator_tag的同义词，表示该迭代器是一个随机访问迭代器。

成员函数文档

[constexpr noexcept default] ConstIterator::ConstIterator()

构建一个未初始化的迭代器。

不得对未初始化的迭代器调用诸如key()、value() 和 operator++() 之类的函数。在使用该迭代器之前，请使用 operator=() 向其赋值。

另请参阅 QCborMap::constBegin() 和QCborMap::constEnd()。

[constexpr noexcept default] ConstIterator::ConstIterator(const QCborMap::ConstIterator &other)

构建一个迭代器，将其作为other 的副本。

[constexpr noexcept default] ConstIterator::~ConstIterator()

销毁ConstIterator 的实例。

QCborValue ConstIterator::key() const

返回当前项的键。

另请参阅 value()。

QCborValueConstRef ConstIterator::value() const

返回当前项的值。

另请参阅 key() 和operator*()。

QCborMap::ConstIterator::value_type ConstIterator::operator*() const

返回一个包含当前项的键和值的元组。

另请参阅 ` key()` 和 `value()`。

QCborMap::ConstIterator ConstIterator::operator+(qsizetype j) const

返回一个迭代器，该迭代器指向距离当前迭代器向前j 个位置处的项目。如果j 为负数，则迭代器向后移动。

另请参阅 operator-()。

QCborMap::ConstIterator &ConstIterator::operator++()

前缀++ 运算符（++i ）将迭代器向前移动到map中的下一个元素，并返回该迭代器。

在 `QCborMap::end()` 上调用此函数将导致未定义的结果。

另请参阅 operator--()。

QCborMap::ConstIterator ConstIterator::operator++(int)

后缀运算符++ （i++ ）将迭代器向前移动到映射中的下一个项，并返回指向前一个当前项的迭代器。

这是一个重载函数。

QCborMap::ConstIterator &ConstIterator::operator+=(qsizetype j)

将迭代器向前移动j 个元素。如果j 为负数，则迭代器向后移动。返回对此迭代器的引用。

另请参阅 operator-=() 和operator+()。

qsizetype ConstIterator::operator-(QCborMap::ConstIterator j) const

返回迭代器j 处项相对于当前迭代器处项的位置。如果j 处项位于当前项之前，则返回值为负数。

另请参见 operator+()。

QCborMap::ConstIterator ConstIterator::operator-(qsizetype j) const

返回一个迭代器，指向从该迭代器向后移动j 个位置处的项目。如果j 为负数，则迭代器向前移动。

另请参阅 operator+()。

QCborMap::ConstIterator &ConstIterator::operator--()

前缀-- 运算符（--i ）将前一个元素设为当前元素，并返回该迭代器。

在 `QCborMap::begin()` 上调用此函数将导致未定义的结果。

另请参阅 operator++()。

QCborMap::ConstIterator ConstIterator::operator--(int)

后缀运算符-- （i-- ）将前一个元素设为当前元素，并返回一个指向先前当前元素的迭代器。

这是一个重载函数。

QCborMap::ConstIterator &ConstIterator::operator-=(qsizetype j)

使迭代器向后移动j 个元素。如果j 为负数，则迭代器向前移动。返回对此迭代器的引用。

另请参阅 operator+=() 和operator-()。

const QCborValueConstRef *ConstIterator::operator->() const

返回指向当前数组对的值的指针。

QCborMap::ConstIterator &ConstIterator::operator=(const QCborMap::ConstIterator &other)

将该迭代器作为other 的副本，并返回对此迭代器的引用。

相关的非成员

[noexcept] bool operator!=(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

如果 `lhs ` 指向的映射条目与 `rhs ` 迭代器指向的条目不同，则返回 `true `；否则返回 `false`。

另请参阅 operator==()。

[noexcept] bool operator<(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

如果由迭代器 `lhs ` 指向的映射条目出现在迭代器 `rhs ` 指向的条目之前，则返回 `true `。

[noexcept] bool operator<=(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

如果由迭代器 `lhs ` 指向的映射中的条目出现在迭代器 `rhs ` 指向的条目之前，或者与后者为同一条目，则返回 `true `。

[noexcept] bool operator==(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

如果 `lhs ` 指向的映射条目与 `rhs ` 迭代器指向的条目相同，则返回 `true `；否则返回 `false`。

另请参阅 operator!=()。

[noexcept] bool operator>(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

如果由迭代器 `lhs ` 指向的映射中的条目出现在迭代器 `rhs ` 指向的条目之后，则返回 `true `。

[noexcept] bool operator>=(const QCborMap::ConstIterator &lhs, const QCborMap::ConstIterator &rhs)

如果由迭代器 `lhs ` 指向的映射中的条目出现在迭代器 `rhs ` 指向的条目之后，或者与该条目相同，则返回 `true `。

© 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.