Класс ConstIterator

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

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

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

Типы публичного доступа

Функции публичного доступа

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

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

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

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

Несколько итераторов могут использоваться для одного массива. Однако имейте в виду, что любой вызов неконстантной функции для 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+().