Класс ConstIterator

Класс QCborArray::ConstIterator предоставляет итератор типа const для QCborArray в стиле STL. Подробнее...

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

Типы public

Функции public

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

Класс QCborArray::ConstIterator предоставляет итератор типа const для QCborArray в стиле STL.

QCborArray::ConstIterator позволяет перебирать элементы QCborArray. Если вам нужно изменить QCborArray во время перебора, используйте QCborArray::Iterator вместо этого. Рекомендуется использовать QCborArray::ConstIterator, даже для не-const QCborArray, когда вам не нужно изменять QCborArray через итератор. Const итераторы немного быстрее и улучшают читабельность кода.

Итераторы инициализируются с помощью функций QCborArray, таких как QCborArray::begin() или QCborArray::end(). Перебор возможен только после инициализации.

Большинство функций QCborArray принимают целочисленный индекс, а не итератор. По этой причине итераторы редко используются в связи с QCborArray. Одно место, где STL-стиль итераторов имеет смысл, - это в качестве аргументов для общих алгоритмов.

Можно использовать несколько итераторов для одного массива. Однако, имейте в виду, что любое обращение к не-const функции QCborArray сделает все существующие итераторы неопределенными.

См. также QCborArray::Iterator.

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

typedef ConstIterator::iterator_category

Синоним для std::random_access_iterator_tag, указывающий, что этот итератор является итератором произвольного доступа.

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

Возвращает true, если элемент массива, на который указывает этот итератор, следует за или совпадает с элементом, на который указывает итератор other.

Возвращает true, если элемент массива, на который указывает этот итератор, следует за элементом, на который указывает итератор other.

Возвращает true, если элемент массива, на который указывает этот итератор, предшествует или совпадает с элементом, на который указывает итератор other.

Возвращает true, если элемент массива, на который указывает этот итератор, предшествует элементу, на который указывает итератор other.

Возвращает true если o указывает на другую запись в массиве, чем этот итератор; в противном случае возвращает false.

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

Возвращает true если other указывает на ту же запись в массиве, что и этот итератор; в противном случае возвращает false.

См. также operator!=().

ConstIterator::ConstIterator()

Создаёт неинициализированный итератор.

Функции, такие как operator*() и operator++(), не должны вызываться для неинициализированного итератора. Используйте operator=() для присваивания значения перед использованием.

См. также QCborArray::constBegin() и QCborArray::constEnd().

ConstIterator::ConstIterator(const ConstIterator &other)

Создаёт копию other.

const QCborValueRef ConstIterator::operator*() const

Возвращает текущий элемент.

ConstIterator ConstIterator::operator+(qsizetype j) const

Возвращает итератор к элементу, находящемуся на позиции, смещённой вперёд на j шагов от текущего итератора. Если j отрицательно, итератор перемещается назад.

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

ConstIterator &ConstIterator::operator++()

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

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

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

ConstIterator ConstIterator::operator++(int)

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

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

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

Перемещает итератор на j позиций вперёд. Если j отрицательно, итератор перемещается назад. Возвращает ссылку на этот итератор.

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

ConstIterator ConstIterator::operator-(qsizetype j) const

Возвращает итератор к элементу, находящемуся на позиции, смещённой назад на j шагов от текущего итератора. Если j отрицательно, итератор перемещается вперёд.

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

qsizetype ConstIterator::operator-(ConstIterator other) const

Возвращает смещение этого итератора относительно other.

ConstIterator &ConstIterator::operator--()

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

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

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

ConstIterator ConstIterator::operator--(int)

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

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

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

Перемещает итератор назад на j позиций. Если j отрицательно, итератор перемещается вперёд. Возвращает ссылку на этот итератор.

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

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

Возвращает указатель на текущий элемент.

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

Делает этот итератор копией other и возвращает ссылку на этот итератор.

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

Возвращает элемент, находящийся на позиции, смещённой вперёд на j шагов от элемента, на который указывает этот итератор.

Эта функция предоставляется для того, чтобы итераторы QCborArray вели себя как указатели C++.

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