QCborArray::Iterator Class

成员函数文档

[constexpr noexcept] Iterator::Iterator()

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

不应在未初始化的迭代器上调用 operator*() 和 operator++() 等函数。在使用迭代器之前，请使用 operator=() 为其赋值。

另请参阅 QCborArray::begin() 和QCborArray::end()。

[constexpr noexcept] Iterator::Iterator(const QCborArray::Iterator &other)

复制other 。

QCborValueRef Iterator::operator*() const

返回当前项目的可修改引用。

您可以在赋值的左侧使用操作符*()来更改项的值。

返回值的类型是 QCborValueRef，它是QCborArray 和QCborMap 的辅助类。当获得 QCborValueRef 类型的对象时，可以将其作为QCborValue 的引用来使用。如果对其赋值，赋值将应用于QCborArray 或QCborMap 中的元素，而您正是通过该元素获得了引用。

QCborArray::Iterator Iterator::operator+(qsizetype j) const

返回位于j 位置的项目的迭代器。如果j 为负数，则迭代器向后退。

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

QCborArray::Iterator &Iterator::operator++()

++ 前缀操作符++it 将迭代器前进到数组中的下一项，并返回该迭代器。

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

另请参见 operator--()。

QCborArray::Iterator Iterator::operator++(int)

这是一个重载函数。

后缀++ 运算符it++ 将迭代器前进到数组中的下一个项目，并返回一个指向先前当前项目的迭代器。

QCborArray::Iterator &Iterator::operator+=(qsizetype j)

将迭代器向前推进j 个位置。如果j 为负数，迭代器会向后退。返回对该迭代器的引用。

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

qsizetype Iterator::operator-(QCborArray::Iterator other) const

返回该迭代器相对于other 的偏移量。

QCborArray::Iterator Iterator::operator-(qsizetype j) const

返回位于j 位置的项目的迭代器。如果j 为负数，则迭代器向前移动。

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

QCborArray::Iterator &Iterator::operator--()

前缀-- 操作符--it 使前一项成为当前项，并返回该迭代器。

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

另请参见 operator++()。

QCborArray::Iterator Iterator::operator--(int)

这是一个重载函数。

后缀-- 运算符it-- 使前一个项目成为当前项目，并返回一个指向前一个当前项目的迭代器。

QCborArray::Iterator &Iterator::operator-=(qsizetype j)

使迭代器返回j 位置。如果j 为负数，则迭代器向前移动。返回对该迭代器的引用。

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

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

返回指向当前项目可修改引用的指针。

QCborArray::Iterator &Iterator::operator=(const QCborArray::Iterator &other)

使该迭代器成为other 的副本，并返回该迭代器的引用。

QCborValueRef Iterator::operator[](qsizetype j) const

返回从该迭代器指向的项目向前移动j 步的项目的可修改引用。

提供该函数是为了使QCborArray 迭代器的行为类似于 C++ 指针。

返回值的类型为 QCborValueRef，它是QCborArray 和QCborMap 的辅助类。当您获得 QCborValueRef 类型的对象时，可以像使用QCborValue 的引用一样使用它。如果对它进行赋值，赋值将应用于QCborArray 或QCborMap 中的元素，而您正是通过该元素获得了引用。

另请参阅 operator+()。