Класс ConstIterator

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

Этот класс был представлен в Qt 5.12.

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

Открытые типы

Открытые функции

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

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(const ConstIterator &other)

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

ConstIterator::ConstIterator()

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

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

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

ConstIterator &ConstIterator::operator=(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

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

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

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

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

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