Класс iterator

Класс QList::iterator предоставляет итератор в стиле STL для QList и QQueue, не являющийся константным. Подробнее...

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

Типы public

Функции public

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

Класс 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 << 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, указывающий, что этот итератор — итератор с произвольным доступом.

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

iterator::iterator()

Конструирует неинициализированный итератор.

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

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

iterator::iterator(const iterator &other)

Конструирует копию other.

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

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

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

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

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

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

T &iterator::operator*() const

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

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

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

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

итератор iterator::operator+(difference_type j) const

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

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

итератор &iterator::operator++()

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

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

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

итератор iterator::operator++(int)

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

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

итератор &iterator::operator+=(difference_type j)

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

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

итератор iterator::operator-(difference_type j) const

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

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

int iterator::operator-(итератор other) const

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

итератор &iterator::operator--()

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

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

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

итератор iterator::operator--(int)

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

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

итератор &iterator::operator-=(difference_type j)

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

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

T *iterator::operator->() const

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

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

bool iterator::operator<(const итератор &other) const

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

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

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

bool iterator::operator<=(const итератор &other) const

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

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

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

bool iterator::operator==(const итератор &other) const

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

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

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

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

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

bool iterator::operator>(const итератор &other) const

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

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

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

bool iterator::operator>=(const итератор &other) const

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

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

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

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

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

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

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