Класс iterator

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

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

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

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

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

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

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

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

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

QList<QString>::iterator i;
for (i = list.begin(); i != list.end(); ++i)
    cout << *i << Qt::endl;

Давайте посмотрим несколько примеров того, что можно сделать с QList::iterator, чего нельзя сделать с QList::const_iterator. Вот пример, который увеличивает каждое значение, хранящееся в QList<int>, на 2:

QList<int>::iterator i;
for (i = list.begin(); i != list.end(); ++i)
    *i += 2;

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

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

QList<QWidget *> list;
...
qDeleteAll(list.begin(), list.end());

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

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

См. также QList::const_iterator и QMutableListIterator.

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

typedef iterator::iterator_category

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

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

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

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

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

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

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

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

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

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

iterator::iterator(const iterator &other)

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

iterator::iterator()

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

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

См. также QList::begin() и QList::end().

T &iterator::operator*() const

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

Вы можете изменить значение элемента, используя operator*() слева от оператора присваивания, например:

if (*it == "Hello")
    *it = "Bonjour";

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

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

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

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

iterator &iterator::operator++()

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

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

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

iterator iterator::operator++(int)

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

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

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

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

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

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

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

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

int iterator::operator-(iterator other) const

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

iterator &iterator::operator--()

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

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

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

iterator iterator::operator--(int)

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

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

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

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

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

T *iterator::operator->() const

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

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

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

Возвращает изменяемую ссылку на элемент по позиции *this + j.

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

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