Класс 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.

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

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+().