QListIterator Class ReferenceThe QListIterator class provides a Java-style const iterator for QList and QQueue. Далее... #include <QListIterator>
Открытые функции
Подробное описаниеThe QListIterator class provides a Java-style const iterator for QList and QQueue. QList has both Java-style iterators and STL-style iterators. Итераторы в стиле Java более высокоуровневые и простые в использовании, чем итераторы в стиле STL; с другой стороны, они несколько менее эффективны. Альтернативой использованию итераторов является использование индекса позиций. Most QList member functions take an index as their first parameter, making it possible to access, modify, and remove items without using iterators. QListIterator<T> allows you to iterate over a QList<T> (or a QQueue<T>). If you want to modify the list as you iterate over it, use QMutableListIterator<T> instead. The QListIterator constructor takes a QList as argument. After construction, the iterator is located at the very beginning of the list (before the first item). Вот, как последовательно перебрать все элементы: QList<float> list; ... QListIterator<float> i(list); while (i.hasNext()) qDebug() << i.next(); The next() function returns the next item in the list and advances the iterator. В отличие от итераторов в стиле STL, итераторы в стиле Java указывают между элементами, а не на сами элементы. The first call to next() advances the iterator to the position between the first and second item, and returns the first item; the second call to next() advances the iterator to the position between the second and third item, and returns the second item; and so on. Вот, как последовательно перебрать все элементы в обратном порядке: QListIterator<float> i(list); i.toBack(); while (i.hasPrevious()) qDebug() << i.previous(); Если вы хотите найти все вхождения определённого значения, используйте findNext() или findPrevious() в цикле. Multiple iterators can be used on the same list. If the list is modified while a QListIterator is active, the QListIterator will continue iterating over the original list, ignoring the modified copy. See also QMutableListIterator and QList::const_iterator. Описание функций-членовQListIterator::QListIterator ( const QList<T> & list )Constructs an iterator for traversing list. The iterator is set to be at the front of the list (before the first item). Смотрите также operator=(). bool QListIterator::findNext ( const T & value )Ищет вперед значение value, начиная с текущей позиции итератора. Возвращает true, если value найдено; в противном случае возвращает false. После вызова, если значение value было найдено, итератор устанавливается сразу после соответствующего элемента; в противном случае итератор устанавливается позади контейнера. Смотрите также findPrevious(). bool QListIterator::findPrevious ( const T & value )Ищет назад значение value, начиная с текущей позиции итератора. Возвращает true, если value найдено; в противном случае возвращает false. После вызова, если значение value было найдено, итератор устанавливается сразу перед соответствующим элементом; в противном случае итератор устанавливается перед контейнером. Смотрите также findNext(). bool QListIterator::hasNext () constВозвращает true, если есть хотя бы один элемент впереди итератора, т.е. итератор не позади контейнера; в противном случае возвращает false. Смотрите также hasPrevious() и next(). bool QListIterator::hasPrevious () constВозвращает true, если есть хотя бы один элемент позади итератора, т.е. итератор не впереди контейнера; в противном случае возвращает false. Смотрите также hasNext() и previous(). const T & QListIterator::next ()Возвращает следующий элемент и перемещает итератор на одну позицию. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), peekNext() и previous(). const T & QListIterator::peekNext () constВозвращает следующий элемент без перемещения итератора. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), next() и peekPrevious(). const T & QListIterator::peekPrevious () constВозвращает предыдущий элемент без перемещения итератора. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), previous() и peekNext(). const T & QListIterator::previous ()Возвращает предыдущий элемент и перемещает итератор на одну позицию назад. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), peekPrevious() и next(). void QListIterator::toBack ()Перемещает итератор позади контейнера (после последнего элемента). Смотрите также toFront() и previous(). void QListIterator::toFront ()Перемещает итератор впереди контейнера (перед первым элементом). Смотрите также toBack() и next(). QListIterator & QListIterator::operator= ( const QList<T> & list )Makes the iterator operate on list. The iterator is set to be at the front of the list (before the first item). |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |