QMutableMapIterator Class ReferenceThe QMutableMapIterator class provides a Java-style non-const iterator for QMap and QMultiMap. Далее... #include <QMutableMapIterator>
Открытые функции
Подробное описаниеThe QMutableMapIterator class provides a Java-style non-const iterator for QMap and QMultiMap. QMap has both Java-style iterators and STL-style iterators. Итераторы в стиле Java более высокоуровневые и простые в использовании, чем итераторы в стиле STL; с другой стороны, они несколько менее эффективны. QMutableMapIterator<Key, T> allows you to iterate over a QMap (or a QMultiMap) and modify the map. If you don't want to modify the map (or have a const QMap), use the slightly faster QMapIterator instead. The QMutableMapIterator constructor takes a QMap as argument. After construction, the iterator is located at the very beginning of the map (before the first item). Вот, как последовательно перебрать все элементы: QMap<int, QWidget *> map; ... QMutableMapIterator<int, QWidget *> i(map); while (i.hasNext()) { i.next(); qDebug() << i.key() << ": " << i.value(); } The next() function returns the next item in the map and advances the iterator. The key() and value() functions return the key and value of the last item that was jumped over. Unlike STL-style iterators, Java-style iterators point between items rather than directly at items. 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 so on. Вот, как последовательно перебрать все элементы в обратном порядке: QMutableMapIterator<int, QWidget *> i(map); i.toBack(); while (i.hasPrevious()) { i.previous(); qDebug() << i.key() << ": " << i.value(); } Если вы хотите найти все вхождения определённого значения, используйте findNext() или findPrevious() в цикле. Например: QMutableMapIterator<int, QWidget *> i(map); while (i.findNext(widget)) { qDebug() << "Found widget " << widget << " under key " << i.key(); } If you want to remove items as you iterate over the map, use remove(). If you want to modify the value of an item, use setValue(). Пример: QMutableMapIterator<QString, QString> i(map); while (i.hasNext()) { i.next(); if (i.key() == i.value()) i.remove(); } The example removes all (key, value) pairs where the key and the value are the same. Only one mutable iterator can be active on a given map at any time. Furthermore, no changes should be done directly to the map while the iterator is active (as opposed to through the iterator), since this could invalidate the iterator and lead to undefined behavior. See also QMapIterator and QMap::iterator. Описание функций-членовQMutableMapIterator::QMutableMapIterator ( QMap<Key, T> & map )Constructs an iterator for traversing map. The iterator is set to be at the front of the map (before the first item). Смотрите также operator=(). QMutableMapIterator::~QMutableMapIterator ()Destroys the iterator. Смотрите также operator=(). bool QMutableMapIterator::findNext ( const T & value )Ищет вперед значение value, начиная с текущей позиции итератора. Returns true if a (key, value) pair with value value is found; otherwise returns false. После вызова, если значение value было найдено, итератор устанавливается сразу после соответствующего элемента; в противном случае итератор устанавливается позади контейнера. Смотрите также findPrevious(). bool QMutableMapIterator::findPrevious ( const T & value )Ищет назад значение value, начиная с текущей позиции итератора. Returns true if a (key, value) pair with value value is found; otherwise returns false. После вызова, если значение value было найдено, итератор устанавливается сразу перед соответствующим элементом; в противном случае итератор устанавливается перед контейнером. Смотрите также findNext(). bool QMutableMapIterator::hasNext () constВозвращает true, если есть хотя бы один элемент впереди итератора, т.е. итератор не позади контейнера; в противном случае возвращает false. Смотрите также hasPrevious() и next(). bool QMutableMapIterator::hasPrevious () constВозвращает true, если есть хотя бы один элемент позади итератора, т.е. итератор не впереди контейнера; в противном случае возвращает false. Смотрите также hasNext() и previous(). const Key & QMutableMapIterator::key () constReturns the key 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(), key() is equivalent to peekPrevious().key(). After a call to previous() or findPrevious(), key() is equivalent to peekNext().key(). Смотрите также value(). Item QMutableMapIterator::next ()Возвращает следующий элемент и перемещает итератор на одну позицию. Call key() on the return value to obtain the item's key, and value() to obtain the value. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), peekNext() и previous(). Item QMutableMapIterator::peekNext () constReturns a reference to the next item without moving the iterator. Call key() on the return value to obtain the item's key, and value() to obtain the value. Вызов этой функции на итераторе, расположенном позади контейнера, приводит к неопределённым результатам. Смотрите также hasNext(), next() и peekPrevious(). Item QMutableMapIterator::peekPrevious () constВозвращает предыдущий элемент без перемещения итератора. Call key() on the return value to obtain the item's key, and value() to obtain the value. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), previous() и peekNext(). Item QMutableMapIterator::previous ()Возвращает предыдущий элемент и перемещает итератор на одну позицию назад. Call key() on the return value to obtain the item's key, and value() to obtain the value. Вызов этой функции на итераторе, расположенном перед контейнером, приводит к неопределённым результатам. Смотрите также hasPrevious(), peekPrevious() и next(). void QMutableMapIterator::remove ()Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). Смотрите также setValue(). void QMutableMapIterator::setValue ( const T & value )Replaces 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(). See also key(), value(), and remove(). void QMutableMapIterator::toBack ()Перемещает итератор позади контейнера (после последнего элемента). Смотрите также toFront() и previous(). void QMutableMapIterator::toFront ()Перемещает итератор впереди контейнера (перед первым элементом). Смотрите также toBack() и next(). const T & QMutableMapIterator::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().value(). After a call to previous() or findPrevious(), value() is equivalent to peekNext().value(). See also key() and setValue(). T & QMutableMapIterator::value ()Это перегруженная функция. Returns a non-const reference to the value of the last item that was jumped over using one of the traversal functions. QMutableMapIterator & QMutableMapIterator::operator= ( QMap<Key, T> & map )Makes the iterator operate on map. The iterator is set to be at the front of the map (before the first item). |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |