QMutableSetIterator Class ReferenceThe QMutableSetIterator class provides a Java-style non-const iterator for QSet. Далее... #include <QMutableSetIterator> Класс был добавлен в Qt 4.2. Открытые функции
Подробное описаниеThe QMutableSetIterator class provides a Java-style non-const iterator for QSet. QSet has both Java-style iterators and STL-style iterators. Итераторы в стиле Java более высокоуровневые и простые в использовании, чем итераторы в стиле STL; с другой стороны, они несколько менее эффективны. QMutableSetIterator<T> allows you to iterate over a QSet<T> and remove items from the set as you iterate. If you don't want to modify the set (or have a const QSet), use the slightly faster QSetIterator<T> instead. The QMutableSetIterator constructor takes a QSet as argument. After construction, the iterator is located at the very beginning of the set (before the first item). Вот, как последовательно перебрать все элементы: QSet<float> set; ... QMutableSetIterator<float> i(set); while (i.hasNext()) qDebug() << i.next(); The next() function returns the next item in the set and advances the iterator. В отличие от итераторов в стиле STL, итераторы в стиле Java указывают между элементами, а не на сами элементы. Первый вызов next() перемещает итератор в позицию между первым и вторым элементами и возвращает первый элемент; второй вызов next() перемещает итератор в позицию между вторым и третьим элементами, возвращая второй элемент; и т.д. Вот, как последовательно перебрать все элементы в обратном порядке: QMutableSetIterator<float> i(set); i.toBack(); while (i.hasPrevious()) qDebug() << i.previous(); If you want to remove items as you iterate over the set, use remove(). Only one mutable iterator can be active on a given set at any time. Furthermore, no changes should be done directly to the set while the iterator is active (as opposed to through the iterator), since this could invalidate the iterator and lead to undefined behavior. See also QSetIterator and QSet::iterator. Описание функций-членовQMutableSetIterator::QMutableSetIterator ( QSet<T> & set )Constructs an iterator for traversing set. The iterator is set to be at the front of the set (before the first item). Смотрите также operator=(). QMutableSetIterator::~QMutableSetIterator ()Destroys the iterator. Смотрите также operator=(). bool QMutableSetIterator::findNext ( const T & value )Ищет вперед значение value, начиная с текущей позиции итератора. Возвращает true, если value найдено; в противном случае возвращает false. После вызова, если значение value было найдено, итератор устанавливается сразу после соответствующего элемента; в противном случае итератор устанавливается позади контейнера. Смотрите также findPrevious(). bool QMutableSetIterator::findPrevious ( const T & value )Ищет назад значение value, начиная с текущей позиции итератора. Возвращает true, если value найдено; в противном случае возвращает false. После вызова, если значение value было найдено, итератор устанавливается сразу перед соответствующим элементом; в противном случае итератор устанавливается перед контейнером. Смотрите также findNext(). bool QMutableSetIterator::hasNext () constВозвращает true, если есть хотя бы один элемент впереди итератора, т.е. итератор не позади контейнера; в противном случае возвращает false. Смотрите также hasPrevious() и next(). bool QMutableSetIterator::hasPrevious () constВозвращает true, если есть хотя бы один элемент позади итератора, т.е. итератор не впереди контейнера; в противном случае возвращает false. Смотрите также hasNext() и previous(). const T & QMutableSetIterator::next ()Возвращает следующий элемент и перемещает итератор на одну позицию. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), peekNext() и previous(). const T & QMutableSetIterator::peekNext () constВозвращает следующий элемент без перемещения итератора. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), next() и peekPrevious(). const T & QMutableSetIterator::peekPrevious () constВозвращает предыдущий элемент без перемещения итератора. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), previous() и peekNext(). const T & QMutableSetIterator::previous ()Возвращает предыдущий элемент и перемещает итератор на одну позицию назад. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), peekPrevious() и next(). void QMutableSetIterator::remove ()Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). Пример: QMutableSetIterator<int> i(set); while (i.hasNext()) { int val = i.next(); if (val < -32768 || val > 32767) i.remove(); } Смотрите также value(). void QMutableSetIterator::toBack ()Перемещает итератор позади контейнера (после последнего элемента). Смотрите также toFront() и previous(). void QMutableSetIterator::toFront ()Перемещает итератор впереди контейнера (перед первым элементом). Смотрите также toBack() и next(). const T & QMutableSetIterator::value () constReturns the value of the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). After a call to next() or findNext(), value() is equivalent to peekPrevious(). After a call to previous() or findPrevious(), value() is equivalent to peekNext(). QMutableSetIterator & QMutableSetIterator::operator= ( QSet<T> & set )Makes the iterator operate on set. The iterator is set to be at the front of the set (before the first item). |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |