Класс const_iterator

Класс QList::const_iterator предоставляет итератор типа const iterator в стиле STL для QList и QQueue. Подробнее...

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

Типы Public

Функции Public

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

Класс QList::const_iterator предоставляет итератор типа const iterator в стиле STL для QList и QQueue.

QList предоставляет как итераторы в стиле STL, так и итераторы в стиле Java. Итераторы в стиле STL более низкого уровня и более сложны в использовании; с другой стороны, они немного быстрее и для разработчиков, знакомых со STL, обладают преимуществом знакомства.

QList<T>::const_iterator позволяет перебирать QList<T> (или QQueue<T>). Если вы хотите изменить QList во время итерации, используйте QList::iterator вместо этого. В целом, рекомендуется использовать QList::const_iterator на не-константном QList, если вам не нужно изменять QList с помощью итератора. Константные итераторы немного быстрее и могут улучшить читаемость кода.

Конструктор по умолчанию QList::const_iterator создаёт неинициализированный итератор. Необходимо инициализировать его с помощью функции QList, такой как QList::constBegin(), QList::constEnd() или QList::insert(), прежде чем начать итерацию. Вот типичный цикл, который выводит все элементы, хранящиеся в списке:

QList<QString> list;
list.append("January");
list.append("February");
...
list.append("December");

QList<QString>::const_iterator i;
for (i = list.constBegin(); i != list.constEnd(); ++i)
    cout << *i << endl;

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

Например, вот как удалить все виджеты, хранящиеся в QList<QWidget *>:

QList<QWidget *> list;
...
qDeleteAll(list.constBegin(), list.constEnd());

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

Предупреждение: Итераторы неявно разделяемых контейнеров не работают точно как итераторы STL. Следует избегать копирования контейнера, пока итераторы активны в этом контейнере. Для получения дополнительной информации см. Проблему итераторов при неявном совместном использовании.

См. также QList::iterator и QListIterator.

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

typedef const_iterator::iterator_category

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

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

const_iterator::const_iterator()

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

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

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

const_iterator::const_iterator(const const_iterator &other)

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

const_iterator::const_iterator(const iterator &other)

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

bool const_iterator::operator!=(const const_iterator &other) const

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

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

const T &const_iterator::operator*() const

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

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

const_iterator const_iterator::operator+(const_iterator::difference_type j) const

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

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

const_iterator &const_iterator::operator++()

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

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

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

const_iterator const_iterator::operator++(int)

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

Оператор постфиксного инкремента ++ (it++) перемещает итератор к следующему элементу в списке и возвращает итератор к предыдущему текущему элементу.

const_iterator &const_iterator::operator+=(const_iterator::difference_type j)

Перемещает итератор на j элементов. (Если j отрицательное, итератор перемещается назад.)

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

const_iterator const_iterator::operator-(const_iterator::difference_type j) const

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

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

int const_iterator::operator-(const_iterator other) const

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

const_iterator &const_iterator::operator--()

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

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

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

const_iterator const_iterator::operator--(int)

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

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

const_iterator &const_iterator::operator-=(const_iterator::difference_type j)

Перемещает итератор назад на j элементов. (Если j отрицательное, итератор перемещается вперёд.)

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

const T *const_iterator::operator->() const

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

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

bool const_iterator::operator<(const const_iterator &other) const

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

bool const_iterator::operator<=(const const_iterator &other) const

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

bool const_iterator::operator==(const const_iterator &other) const

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

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

bool const_iterator::operator>(const const_iterator &other) const

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

bool const_iterator::operator>=(const const_iterator &other) const

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

const T &const_iterator::operator[](const_iterator::difference_type j) const

Возвращает элемент в позиции *this + j.

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

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