QMutableVectorIterator Class ReferenceThe QMutableVectorIterator class provides a Java-style non-const iterator for QVector and QStack. Далее... #include <QMutableVectorIterator>
Открытые функции
Подробное описаниеThe QMutableVectorIterator class provides a Java-style non-const iterator for QVector and QStack. QVector имеет как итераторы в стиле Java, так и итераторы в стиле STL. Итераторы в стиле Java более высокоуровневые и простые в использовании, чем итераторы в стиле STL; с другой стороны, они несколько менее эффективны. Альтернативой использованию итераторов является использование индекса позиций. Большинство функций-членов QVector принимает индекс в качестве первого параметра, делая возможным доступ, вставку и удаление элементов без использования итераторов. QMutableVectorIterator<T> allows you to iterate over a QVector<T> and modify the vector. If you don't want to modify the vector (or have a const QVector), use the slightly faster QVectorIterator<T> instead. The QMutableVectorIterator constructor takes a QVector as argument. After construction, the iterator is located at the very beginning of the list (before the first item). Вот, как последовательно перебрать все элементы: QVector<float> vector; ... QMutableVectorIterator<float> i(vector); while (i.hasNext()) qDebug() << i.next(); Функция next() возвращает следующий элемент в векторе и перемещает итератор. В отличие от итераторов в стиле STL, итераторы в стиле Java указывают между элементами, а не на сами элементы. Первый вызов next() перемещает итератор в позицию между первым и вторым элементами и возвращает первый элемент; второй вызов next() перемещает итератор в позицию между вторым и третьим элементами, возвращая второй элемент; и т.д. Вот, как последовательно перебрать все элементы в обратном порядке: QMutableVectorIterator<float> i(vector); i.toBack(); while (i.hasPrevious()) qDebug() << i.previous(); Если вы хотите найти все вхождения определённого значения, используйте findNext() или findPrevious() в цикле. If you want to remove items as you iterate over the vector, use remove(). If you want to modify the value of an item, use setValue(). If you want to insert a new item in the vector, use insert(). Пример: QMutableVectorIterator<int> i(vector); while (i.hasNext()) { int val = i.next(); if (val < 0) { i.setValue(-val); } else if (val == 0) { i.remove(); } } The example traverses a vector, replacing negative numbers with their absolute values, and eliminating zeroes. Only one mutable iterator can be active on a given vector at any time. Furthermore, no changes should be done directly to the vector while the iterator is active (as opposed to through the iterator), since this could invalidate the iterator and lead to undefined behavior. See also QVectorIterator and QVector::iterator. Описание функций-членовQMutableVectorIterator::QMutableVectorIterator ( QVector<T> & vector )Создаёт итератор для обхода вектора vector. Итератор устанавливается впереди вектора (перед первым элементом). Смотрите также operator=(). QMutableVectorIterator::~QMutableVectorIterator ()Destroys the iterator. Смотрите также operator=(). bool QMutableVectorIterator::findNext ( const T & value )Ищет вперед значение value, начиная с текущей позиции итератора. Возвращает true, если value найдено; в противном случае возвращает false. После вызова, если значение value было найдено, итератор устанавливается сразу после соответствующего элемента; в противном случае итератор устанавливается позади контейнера. Смотрите также findPrevious(). bool QMutableVectorIterator::findPrevious ( const T & value )Ищет назад значение value, начиная с текущей позиции итератора. Возвращает true, если value найдено; в противном случае возвращает false. После вызова, если значение value было найдено, итератор устанавливается сразу перед соответствующим элементом; в противном случае итератор устанавливается перед контейнером. Смотрите также findNext(). bool QMutableVectorIterator::hasNext () constВозвращает true, если есть хотя бы один элемент впереди итератора, т.е. итератор не позади контейнера; в противном случае возвращает false. Смотрите также hasPrevious() и next(). bool QMutableVectorIterator::hasPrevious () constВозвращает true, если есть хотя бы один элемент позади итератора, т.е. итератор не впереди контейнера; в противном случае возвращает false. Смотрите также hasNext() и previous(). void QMutableVectorIterator::insert ( const T & value )Inserts value at the current iterator position. After the call, the iterator is located just after the inserted item. See also remove() and setValue(). T & QMutableVectorIterator::next ()Returns a reference to the next item, and advances the iterator by one position. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), peekNext() и previous(). T & QMutableVectorIterator::peekNext () constReturns a reference to the next item, without moving the iterator. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), next() и peekPrevious(). T & QMutableVectorIterator::peekPrevious () constReturns a reference to the previous item, without moving the iterator. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), previous() и peekNext(). T & QMutableVectorIterator::previous ()Returns a reference to the previous item and moves the iterator back by one position. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), peekPrevious() и next(). void QMutableVectorIterator::remove ()Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). Пример: QMutableVectorIterator<int> i(vector); while (i.hasNext()) { int val = i.next(); if (val < -32768 || val > 32767) i.remove(); } See also insert() and setValue(). void QMutableVectorIterator::setValue ( const T & value ) constReplaces the value of the last item that was jumped over using one of the traversal functions with value. The traversal functions are next(), previous(), findNext(), and findPrevious(). Пример: QMutableVectorIterator<double> i(list); while (i.hasNext()) { double val = i.next(); i.setValue(sqrt(val)); } See also value(), remove(), and insert(). void QMutableVectorIterator::toBack ()Перемещает итератор позади контейнера (после последнего элемента). Смотрите также toFront() и previous(). void QMutableVectorIterator::toFront ()Перемещает итератор впереди контейнера (перед первым элементом). Смотрите также toBack() и next(). const T & QMutableVectorIterator::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(). Смотрите также setValue(). T & QMutableVectorIterator::value ()Это перегруженная функция. Returns a non-const reference to the value of the last item that was jumped over using one of the traversal functions. QMutableVectorIterator & QMutableVectorIterator::operator= ( QVector<T> & vector )Заставляет итератор работать с вектором vector. Итератор устанавливается впереди вектора (перед первым элементом). |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |