From b23c52ea8110f05def21713934fcc6131f44ec6a Mon Sep 17 00:00:00 2001 From: Martin Smith Date: Wed, 13 Sep 2017 12:07:28 +0200 Subject: Add template text to \fn commands in container classes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The \fn commands were not recognized by clang-qdoc because the template stuff was missing from the \fn commands. This update adds the correct template text and parameters. It eliminates nearly 2000 qdoc warnings. Change-Id: Ibe047424396a8f99f8bd64efea1b0d8cc7c7527d Reviewed-by: Topi Reiniö --- src/corelib/tools/qiterator.qdoc | 472 ++++++++++++++++++++++++--------------- 1 file changed, 297 insertions(+), 175 deletions(-) (limited to 'src/corelib/tools/qiterator.qdoc') diff --git a/src/corelib/tools/qiterator.qdoc b/src/corelib/tools/qiterator.qdoc index 77cc412602..1a70784fab 100644 --- a/src/corelib/tools/qiterator.qdoc +++ b/src/corelib/tools/qiterator.qdoc @@ -25,6 +25,128 @@ ** ****************************************************************************/ +/*! \class QKeyValueIterator + \inmodule QtCore + \since 5.10 + + \brief Iterator over the key/value pairs of an associative container. + + The QKeyValueIterator class provides an STL-style iterator for returning + key/value pairs from associative containers like QHash and QMap. It + supports the same API as the STL associative containers, i.e. getting a + key/value pair when iterating through the container. + + This will allow for better interoperability between QMap, QHash and friends + and STL-style algorithms. + + \warning Iterators on implicitly shared containers do not work + exactly like STL-iterators. You should avoid copying a container + while iterators are active on that container. For more information, + read \l{Implicit sharing iterator problem}. +*/ + +/*! \typedef QKeyValueIterator::iterator_category + \internal +*/ + +/*! \typedef QKeyValueIterator::difference_type + \internal +*/ + +/*! \typedef QKeyValueIterator::value_type + \internal +*/ + +/*! \typedef QKeyValueIterator::pointer + \internal +*/ + +/*! \typedef QKeyValueIterator::reference + \internal +*/ + +/*! \fn template QKeyValueIterator::QKeyValueIterator() + + Constructs a default QKeyValueIterator. +*/ + +/*! \fn template QKeyValueIterator::QKeyValueIterator(Iterator o) + + Constructs a QKeyValueIterator on top of \a o. +*/ + +/*! \fn template const T &QKeyValueIterator::operator*() const + + Returns the current entry as a pair. +*/ + +/*! \fn template bool operator==(QKeyValueIterator lhs, QKeyValueIterator rhs) + \relates QKeyValueIterator + + Returns \c true if \a rhs points to the same item as \a lhs otherwise returns + \c false. + + \sa operator!=() +*/ + +/*! \fn template bool operator!=(QKeyValueIterator lhs, QKeyValueIterator rhs) const + \relates QKeyValueIterator + + Returns \c true if \a rhs points to a different item than \a lhs otherwise + returns \c false. + + \sa operator==() +*/ + +/*! + \fn template QKeyValueIterator &QKeyValueIterator::operator++() + + The prefix ++ operator (\c{++i}) advances the iterator to the + next item in the container and returns the iterator. + + \note Advancing the iterator past its container's end() constitutes + undefined behavior. + + \sa operator--() +*/ + +/*! \fn template QKeyValueIterator QKeyValueIterator::operator++(int) + + \overload + + The postfix ++ operator (\c{i++}) advances the iterator to the + next item in the container and returns the iterator's prior value. + + \note Advancing the iterator past its container's end() constitutes + undefined behavior. +*/ + +/*! \fn template QKeyValueIterator &QKeyValueIterator::operator--() + + The prefix -- operator (\c{--i}) backs the iterator up to the previous item + in the container and returns the iterator. + + \note Backing up an iterator to before its container's begin() constitutes + undefined behavior. + + \sa operator++() +*/ + +/*! \fn template QKeyValueIterator QKeyValueIterator::operator--(int) + + \overload + + The postfix -- operator (\c{i--}) backs the iterator up to the previous item + in the container and returns the iterator's prior value. + + \note Backing up an iterator to before its container's begin() constitutes + undefined behavior. +*/ + +/*! \fn template Iterator QKeyValueIterator::base() const + Returns the underlying iterator this QKeyValueIterator is based on. +*/ + /*! \class QListIterator \inmodule QtCore @@ -470,10 +592,10 @@ */ /*! - \fn QListIterator::QListIterator(const QList &list) - \fn QLinkedListIterator::QLinkedListIterator(const QLinkedList &list) - \fn QMutableListIterator::QMutableListIterator(QList &list) - \fn QMutableLinkedListIterator::QMutableLinkedListIterator(QLinkedList &list) + \fn template QListIterator::QListIterator(const QList &list) + \fn template QLinkedListIterator::QLinkedListIterator(const QLinkedList &list) + \fn template QMutableListIterator::QMutableListIterator(QList &list) + \fn template QMutableLinkedListIterator::QMutableLinkedListIterator(QLinkedList &list) Constructs an iterator for traversing \a list. The iterator is set to be at the front of the list (before the first item). @@ -482,8 +604,8 @@ */ /*! - \fn QVectorIterator::QVectorIterator(const QVector &vector) - \fn QMutableVectorIterator::QMutableVectorIterator(QVector &vector) + \fn template QVectorIterator::QVectorIterator(const QVector &vector) + \fn template QMutableVectorIterator::QMutableVectorIterator(QVector &vector) Constructs an iterator for traversing \a vector. The iterator is set to be at the front of the vector (before the first item). @@ -492,8 +614,8 @@ */ /*! - \fn QSetIterator::QSetIterator(const QSet &set) - \fn QMutableSetIterator::QMutableSetIterator(QSet &set) + \fn template QSetIterator::QSetIterator(const QSet &set) + \fn template QMutableSetIterator::QMutableSetIterator(QSet &set) Constructs an iterator for traversing \a set. The iterator is set to be at the front of the set (before the first item). @@ -501,10 +623,10 @@ \sa operator=() */ -/*! \fn QMutableListIterator &QMutableListIterator::operator=(QList &list) - \fn QMutableLinkedListIterator &QMutableLinkedListIterator::operator=(QLinkedList &list) - \fn QListIterator &QListIterator::operator=(const QList &list) - \fn QLinkedListIterator &QLinkedListIterator::operator=(const QLinkedList &list) +/*! \fn template QMutableListIterator &QMutableListIterator::operator=(QList &list) + \fn template QMutableLinkedListIterator &QMutableLinkedListIterator::operator=(QLinkedList &list) + \fn template QListIterator &QListIterator::operator=(const QList &list) + \fn template QLinkedListIterator &QLinkedListIterator::operator=(const QLinkedList &list) Makes the iterator operate on \a list. The iterator is set to be at the front of the list (before the first item). @@ -512,8 +634,8 @@ \sa toFront(), toBack() */ -/*! \fn QVectorIterator &QVectorIterator::operator=(const QVector &vector) - \fn QMutableVectorIterator &QMutableVectorIterator::operator=(QVector &vector) +/*! \fn template QVectorIterator &QVectorIterator::operator=(const QVector &vector) + \fn template QMutableVectorIterator &QMutableVectorIterator::operator=(QVector &vector) Makes the iterator operate on \a vector. The iterator is set to be at the front of the vector (before the first item). @@ -521,8 +643,8 @@ \sa toFront(), toBack() */ -/*! \fn QSetIterator &QSetIterator::operator=(const QSet &set) - \fn QMutableSetIterator &QMutableSetIterator::operator=(QSet &set) +/*! \fn template QSetIterator &QSetIterator::operator=(const QSet &set) + \fn template QMutableSetIterator &QMutableSetIterator::operator=(QSet &set) Makes the iterator operate on \a set. The iterator is set to be at the front of the set (before the first item). @@ -530,14 +652,14 @@ \sa toFront(), toBack() */ -/*! \fn void QListIterator::toFront() - \fn void QLinkedListIterator::toFront() - \fn void QVectorIterator::toFront() - \fn void QSetIterator::toFront() - \fn void QMutableListIterator::toFront() - \fn void QMutableLinkedListIterator::toFront() - \fn void QMutableVectorIterator::toFront() - \fn void QMutableSetIterator::toFront() +/*! \fn template void QListIterator::toFront() + \fn template void QLinkedListIterator::toFront() + \fn template void QVectorIterator::toFront() + \fn template void QSetIterator::toFront() + \fn template void QMutableListIterator::toFront() + \fn template void QMutableLinkedListIterator::toFront() + \fn template void QMutableVectorIterator::toFront() + \fn template void QMutableSetIterator::toFront() Moves the iterator to the front of the container (before the first item). @@ -545,14 +667,14 @@ \sa toBack(), next() */ -/*! \fn void QListIterator::toBack() - \fn void QLinkedListIterator::toBack() - \fn void QVectorIterator::toBack() - \fn void QSetIterator::toBack() - \fn void QMutableListIterator::toBack() - \fn void QMutableLinkedListIterator::toBack() - \fn void QMutableVectorIterator::toBack() - \fn void QMutableSetIterator::toBack() +/*! \fn template void QListIterator::toBack() + \fn template void QLinkedListIterator::toBack() + \fn template void QVectorIterator::toBack() + \fn template void QSetIterator::toBack() + \fn template void QMutableListIterator::toBack() + \fn template void QMutableLinkedListIterator::toBack() + \fn template void QMutableVectorIterator::toBack() + \fn template void QMutableSetIterator::toBack() Moves the iterator to the back of the container (after the last item). @@ -560,14 +682,14 @@ \sa toFront(), previous() */ -/*! \fn bool QListIterator::hasNext() const - \fn bool QLinkedListIterator::hasNext() const - \fn bool QVectorIterator::hasNext() const - \fn bool QSetIterator::hasNext() const - \fn bool QMutableListIterator::hasNext() const - \fn bool QMutableLinkedListIterator::hasNext() const - \fn bool QMutableVectorIterator::hasNext() const - \fn bool QMutableSetIterator::hasNext() const +/*! \fn template bool QListIterator::hasNext() const + \fn template bool QLinkedListIterator::hasNext() const + \fn template bool QVectorIterator::hasNext() const + \fn template bool QSetIterator::hasNext() const + \fn template bool QMutableListIterator::hasNext() const + \fn template bool QMutableLinkedListIterator::hasNext() const + \fn template bool QMutableVectorIterator::hasNext() const + \fn template bool QMutableSetIterator::hasNext() const Returns \c true if there is at least one item ahead of the iterator, i.e. the iterator is \e not at the back of the container; @@ -576,11 +698,11 @@ \sa hasPrevious(), next() */ -/*! \fn const T &QListIterator::next() - \fn const T &QLinkedListIterator::next() - \fn const T &QVectorIterator::next() - \fn const T &QSetIterator::next() - \fn const T &QMutableSetIterator::next() +/*! \fn template const T &QListIterator::next() + \fn template const T &QLinkedListIterator::next() + \fn template const T &QVectorIterator::next() + \fn template const T &QSetIterator::next() + \fn template const T &QMutableSetIterator::next() Returns the next item and advances the iterator by one position. @@ -590,9 +712,9 @@ \sa hasNext(), peekNext(), previous() */ -/*! \fn T &QMutableListIterator::next() - \fn T &QMutableLinkedListIterator::next() - \fn T &QMutableVectorIterator::next() +/*! \fn template T &QMutableListIterator::next() + \fn template T &QMutableLinkedListIterator::next() + \fn template T &QMutableVectorIterator::next() Returns a reference to the next item, and advances the iterator by one position. @@ -603,11 +725,11 @@ \sa hasNext(), peekNext(), previous() */ -/*! \fn const T &QListIterator::peekNext() const - \fn const T &QLinkedListIterator::peekNext() const - \fn const T &QVectorIterator::peekNext() const - \fn const T &QSetIterator::peekNext() const - \fn const T &QMutableSetIterator::peekNext() const +/*! \fn template const T &QListIterator::peekNext() const + \fn template const T &QLinkedListIterator::peekNext() const + \fn template const T &QVectorIterator::peekNext() const + \fn template const T &QSetIterator::peekNext() const + \fn template const T &QMutableSetIterator::peekNext() const Returns the next item without moving the iterator. @@ -617,9 +739,9 @@ \sa hasNext(), next(), peekPrevious() */ -/*! \fn T &QMutableListIterator::peekNext() const - \fn T &QMutableLinkedListIterator::peekNext() const - \fn T &QMutableVectorIterator::peekNext() const +/*! \fn template T &QMutableListIterator::peekNext() const + \fn template T &QMutableLinkedListIterator::peekNext() const + \fn template T &QMutableVectorIterator::peekNext() const Returns a reference to the next item, without moving the iterator. @@ -629,14 +751,14 @@ \sa hasNext(), next(), peekPrevious() */ -/*! \fn bool QListIterator::hasPrevious() const - \fn bool QLinkedListIterator::hasPrevious() const - \fn bool QVectorIterator::hasPrevious() const - \fn bool QSetIterator::hasPrevious() const - \fn bool QMutableListIterator::hasPrevious() const - \fn bool QMutableLinkedListIterator::hasPrevious() const - \fn bool QMutableVectorIterator::hasPrevious() const - \fn bool QMutableSetIterator::hasPrevious() const +/*! \fn template bool QListIterator::hasPrevious() const + \fn template bool QLinkedListIterator::hasPrevious() const + \fn template bool QVectorIterator::hasPrevious() const + \fn template bool QSetIterator::hasPrevious() const + \fn template bool QMutableListIterator::hasPrevious() const + \fn template bool QMutableLinkedListIterator::hasPrevious() const + \fn template bool QMutableVectorIterator::hasPrevious() const + \fn template bool QMutableSetIterator::hasPrevious() const Returns \c true if there is at least one item behind the iterator, i.e. the iterator is \e not at the front of the container; @@ -645,11 +767,11 @@ \sa hasNext(), previous() */ -/*! \fn const T &QListIterator::previous() - \fn const T &QLinkedListIterator::previous() - \fn const T &QVectorIterator::previous() - \fn const T &QSetIterator::previous() - \fn const T &QMutableSetIterator::previous() +/*! \fn template const T &QListIterator::previous() + \fn template const T &QLinkedListIterator::previous() + \fn template const T &QVectorIterator::previous() + \fn template const T &QSetIterator::previous() + \fn template const T &QMutableSetIterator::previous() Returns the previous item and moves the iterator back by one position. @@ -660,9 +782,9 @@ \sa hasPrevious(), peekPrevious(), next() */ -/*! \fn T &QMutableListIterator::previous() - \fn T &QMutableLinkedListIterator::previous() - \fn T &QMutableVectorIterator::previous() +/*! \fn template T &QMutableListIterator::previous() + \fn template T &QMutableLinkedListIterator::previous() + \fn template T &QMutableVectorIterator::previous() Returns a reference to the previous item and moves the iterator back by one position. @@ -673,11 +795,11 @@ \sa hasPrevious(), peekPrevious(), next() */ -/*! \fn const T &QListIterator::peekPrevious() const - \fn const T &QLinkedListIterator::peekPrevious() const - \fn const T &QVectorIterator::peekPrevious() const - \fn const T &QSetIterator::peekPrevious() const - \fn const T &QMutableSetIterator::peekPrevious() const +/*! \fn template const T &QListIterator::peekPrevious() const + \fn template const T &QLinkedListIterator::peekPrevious() const + \fn template const T &QVectorIterator::peekPrevious() const + \fn template const T &QSetIterator::peekPrevious() const + \fn template const T &QMutableSetIterator::peekPrevious() const Returns the previous item without moving the iterator. @@ -687,9 +809,9 @@ \sa hasPrevious(), previous(), peekNext() */ -/*! \fn T &QMutableListIterator::peekPrevious() const - \fn T &QMutableLinkedListIterator::peekPrevious() const - \fn T &QMutableVectorIterator::peekPrevious() const +/*! \fn template T &QMutableListIterator::peekPrevious() const + \fn template T &QMutableLinkedListIterator::peekPrevious() const + \fn template T &QMutableVectorIterator::peekPrevious() const Returns a reference to the previous item, without moving the iterator. @@ -699,14 +821,14 @@ \sa hasPrevious(), previous(), peekNext() */ -/*! \fn bool QListIterator::findNext(const T &value) - \fn bool QLinkedListIterator::findNext(const T &value) - \fn bool QVectorIterator::findNext(const T &value) - \fn bool QSetIterator::findNext(const T &value) - \fn bool QMutableListIterator::findNext(const T &value) - \fn bool QMutableLinkedListIterator::findNext(const T &value) - \fn bool QMutableVectorIterator::findNext(const T &value) - \fn bool QMutableSetIterator::findNext(const T &value) +/*! \fn template bool QListIterator::findNext(const T &value) + \fn template bool QLinkedListIterator::findNext(const T &value) + \fn template bool QVectorIterator::findNext(const T &value) + \fn template bool QSetIterator::findNext(const T &value) + \fn template bool QMutableListIterator::findNext(const T &value) + \fn template bool QMutableLinkedListIterator::findNext(const T &value) + \fn template bool QMutableVectorIterator::findNext(const T &value) + \fn template bool QMutableSetIterator::findNext(const T &value) Searches for \a value starting from the current iterator position forward. Returns \c true if \a value is found; otherwise returns \c false. @@ -718,14 +840,14 @@ \sa findPrevious() */ -/*! \fn bool QListIterator::findPrevious(const T &value) - \fn bool QLinkedListIterator::findPrevious(const T &value) - \fn bool QVectorIterator::findPrevious(const T &value) - \fn bool QSetIterator::findPrevious(const T &value) - \fn bool QMutableListIterator::findPrevious(const T &value) - \fn bool QMutableLinkedListIterator::findPrevious(const T &value) - \fn bool QMutableVectorIterator::findPrevious(const T &value) - \fn bool QMutableSetIterator::findPrevious(const T &value) +/*! \fn template bool QListIterator::findPrevious(const T &value) + \fn template bool QLinkedListIterator::findPrevious(const T &value) + \fn template bool QVectorIterator::findPrevious(const T &value) + \fn template bool QSetIterator::findPrevious(const T &value) + \fn template bool QMutableListIterator::findPrevious(const T &value) + \fn template bool QMutableLinkedListIterator::findPrevious(const T &value) + \fn template bool QMutableVectorIterator::findPrevious(const T &value) + \fn template bool QMutableSetIterator::findPrevious(const T &value) Searches for \a value starting from the current iterator position backward. Returns \c true if \a value is found; otherwise returns @@ -738,7 +860,7 @@ \sa findNext() */ -/*! \fn void QMutableListIterator::remove() +/*! \fn template void QMutableListIterator::remove() Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). @@ -749,7 +871,7 @@ \sa insert(), setValue() */ -/*! \fn void QMutableLinkedListIterator::remove() +/*! \fn template void QMutableLinkedListIterator::remove() Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). @@ -760,7 +882,7 @@ \sa insert(), setValue() */ -/*! \fn void QMutableVectorIterator::remove() +/*! \fn template void QMutableVectorIterator::remove() Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). @@ -771,7 +893,7 @@ \sa insert(), setValue() */ -/*! \fn void QMutableSetIterator::remove() +/*! \fn template void QMutableSetIterator::remove() Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). @@ -782,7 +904,7 @@ \sa value() */ -/*! \fn void QMutableListIterator::setValue(const T &value) const +/*! \fn template void QMutableListIterator::setValue(const T &value) const Replaces the value of the last item that was jumped over using one of the traversal functions with \a value. @@ -796,7 +918,7 @@ \sa value(), remove(), insert() */ -/*! \fn void QMutableLinkedListIterator::setValue(const T &value) const +/*! \fn template void QMutableLinkedListIterator::setValue(const T &value) const Replaces the value of the last item that was jumped over using one of the traversal functions with \a value. @@ -810,7 +932,7 @@ \sa value(), remove(), insert() */ -/*! \fn void QMutableVectorIterator::setValue(const T &value) const +/*! \fn template void QMutableVectorIterator::setValue(const T &value) const Replaces the value of the last item that was jumped over using one of the traversal functions with \a value. @@ -824,10 +946,10 @@ \sa value(), remove(), insert() */ -/*! \fn const T &QMutableListIterator::value() const - \fn const T &QMutableLinkedListIterator::value() const - \fn const T &QMutableVectorIterator::value() const - \fn const T &QMutableSetIterator::value() const +/*! \fn template const T &QMutableListIterator::value() const + \fn template const T &QMutableLinkedListIterator::value() const + \fn template const T &QMutableVectorIterator::value() const + \fn template const T &QMutableSetIterator::value() const Returns the value of the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), @@ -839,18 +961,18 @@ */ /*! - \fn T &QMutableListIterator::value() - \fn T &QMutableLinkedListIterator::value() - \fn T &QMutableVectorIterator::value() + \fn template T &QMutableListIterator::value() + \fn template T &QMutableLinkedListIterator::value() + \fn template T &QMutableVectorIterator::value() \overload Returns a non-const reference to the value of the last item that was jumped over using one of the traversal functions. */ -/*! \fn void QMutableListIterator::insert(const T &value) - \fn void QMutableLinkedListIterator::insert(const T &value) - \fn void QMutableVectorIterator::insert(const T &value) +/*! \fn template void QMutableListIterator::insert(const T &value) + \fn template void QMutableLinkedListIterator::insert(const T &value) + \fn template void QMutableVectorIterator::insert(const T &value) Inserts \a value at the current iterator position. After the call, the iterator is located just after the inserted item. @@ -1092,8 +1214,8 @@ \sa QHashIterator, QHash::iterator */ -/*! \fn QMapIterator::QMapIterator(const QMap &map) - \fn QMutableMapIterator::QMutableMapIterator(QMap &map) +/*! \fn template QMapIterator::QMapIterator(const QMap &map) + \fn template QMutableMapIterator::QMutableMapIterator(QMap &map) Constructs an iterator for traversing \a map. The iterator is set to be at the front of the map (before the first item). @@ -1101,8 +1223,8 @@ \sa operator=() */ -/*! \fn QHashIterator::QHashIterator(const QHash &hash) - \fn QMutableHashIterator::QMutableHashIterator(QHash &hash) +/*! \fn template QHashIterator::QHashIterator(const QHash &hash) + \fn template QMutableHashIterator::QMutableHashIterator(QHash &hash) Constructs an iterator for traversing \a hash. The iterator is set to be at the front of the hash (before the first item). @@ -1110,8 +1232,8 @@ \sa operator=() */ -/*! \fn QMapIterator &QMapIterator::operator=(const QMap &map) - \fn QMutableMapIterator &QMutableMapIterator::operator=(QMap &map) +/*! \fn template QMapIterator &QMapIterator::operator=(const QMap &map) + \fn template QMutableMapIterator &QMutableMapIterator::operator=(QMap &map) Makes the iterator operate on \a map. The iterator is set to be at the front of the map (before the first item). @@ -1119,8 +1241,8 @@ \sa toFront(), toBack() */ -/*! \fn QHashIterator &QHashIterator::operator=(const QHash &hash) - \fn QMutableHashIterator &QMutableHashIterator::operator=(QHash &hash) +/*! \fn template QHashIterator &QHashIterator::operator=(const QHash &hash) + \fn template QMutableHashIterator &QMutableHashIterator::operator=(QHash &hash) Makes the iterator operate on \a hash. The iterator is set to be at the front of the hash (before the first item). @@ -1128,10 +1250,10 @@ \sa toFront(), toBack() */ -/*! \fn void QMapIterator::toFront() - \fn void QHashIterator::toFront() - \fn void QMutableMapIterator::toFront() - \fn void QMutableHashIterator::toFront() +/*! \fn template void QMapIterator::toFront() + \fn template void QHashIterator::toFront() + \fn template void QMutableMapIterator::toFront() + \fn template void QMutableHashIterator::toFront() Moves the iterator to the front of the container (before the first item). @@ -1139,10 +1261,10 @@ \sa toBack(), next() */ -/*! \fn void QMapIterator::toBack() - \fn void QHashIterator::toBack() - \fn void QMutableMapIterator::toBack() - \fn void QMutableHashIterator::toBack() +/*! \fn template void QMapIterator::toBack() + \fn template void QHashIterator::toBack() + \fn template void QMutableMapIterator::toBack() + \fn template void QMutableHashIterator::toBack() Moves the iterator to the back of the container (after the last item). @@ -1150,10 +1272,10 @@ \sa toFront(), previous() */ -/*! \fn bool QMapIterator::hasNext() const - \fn bool QHashIterator::hasNext() const - \fn bool QMutableMapIterator::hasNext() const - \fn bool QMutableHashIterator::hasNext() const +/*! \fn template bool QMapIterator::hasNext() const + \fn template bool QHashIterator::hasNext() const + \fn template bool QMutableMapIterator::hasNext() const + \fn template bool QMutableHashIterator::hasNext() const Returns \c true if there is at least one item ahead of the iterator, i.e. the iterator is \e not at the back of the container; @@ -1162,8 +1284,8 @@ \sa hasPrevious(), next() */ -/*! \fn QMapIterator::Item QMapIterator::next() - \fn QHashIterator::Item QHashIterator::next() +/*! \fn template QMapIterator::Item QMapIterator::next() + \fn template QHashIterator::Item QHashIterator::next() Returns the next item and advances the iterator by one position. @@ -1176,8 +1298,8 @@ \sa hasNext(), peekNext(), previous() */ -/*! \fn QMutableMapIterator::Item QMutableMapIterator::next() - \fn QMutableHashIterator::Item QMutableHashIterator::next() +/*! \fn template QMutableMapIterator::Item QMutableMapIterator::next() + \fn template QMutableHashIterator::Item QMutableHashIterator::next() Returns the next item and advances the iterator by one position. @@ -1190,8 +1312,8 @@ \sa hasNext(), peekNext(), previous() */ -/*! \fn QMapIterator::Item QMapIterator::peekNext() const - \fn QHashIterator::Item QHashIterator::peekNext() const +/*! \fn template QMapIterator::Item QMapIterator::peekNext() const + \fn template QHashIterator::Item QHashIterator::peekNext() const Returns the next item without moving the iterator. @@ -1204,8 +1326,8 @@ \sa hasNext(), next(), peekPrevious() */ -/*! \fn QMutableMapIterator::Item QMutableMapIterator::peekNext() const - \fn QMutableHashIterator::Item QMutableHashIterator::peekNext() const +/*! \fn template QMutableMapIterator::Item QMutableMapIterator::peekNext() const + \fn template QMutableHashIterator::Item QMutableHashIterator::peekNext() const Returns a reference to the next item without moving the iterator. @@ -1218,10 +1340,10 @@ \sa hasNext(), next(), peekPrevious() */ -/*! \fn bool QMapIterator::hasPrevious() const - \fn bool QHashIterator::hasPrevious() const - \fn bool QMutableMapIterator::hasPrevious() const - \fn bool QMutableHashIterator::hasPrevious() const +/*! \fn template bool QMapIterator::hasPrevious() const + \fn template bool QHashIterator::hasPrevious() const + \fn template bool QMutableMapIterator::hasPrevious() const + \fn template bool QMutableHashIterator::hasPrevious() const Returns \c true if there is at least one item behind the iterator, i.e. the iterator is \e not at the front of the container; @@ -1230,8 +1352,8 @@ \sa hasNext(), previous() */ -/*! \fn QMapIterator::Item QMapIterator::previous() - \fn QHashIterator::Item QHashIterator::previous() +/*! \fn template QMapIterator::Item QMapIterator::previous() + \fn template QHashIterator::Item QHashIterator::previous() Returns the previous item and moves the iterator back by one position. @@ -1245,8 +1367,8 @@ \sa hasPrevious(), peekPrevious(), next() */ -/*! \fn QMutableMapIterator::Item QMutableMapIterator::previous() - \fn QMutableHashIterator::Item QMutableHashIterator::previous() +/*! \fn template QMutableMapIterator::Item QMutableMapIterator::previous() + \fn template QMutableHashIterator::Item QMutableHashIterator::previous() Returns the previous item and moves the iterator back by one position. @@ -1260,8 +1382,8 @@ \sa hasPrevious(), peekPrevious(), next() */ -/*! \fn QMapIterator::Item QMapIterator::peekPrevious() const - \fn QHashIterator::Item QHashIterator::peekPrevious() const +/*! \fn template QMapIterator::Item QMapIterator::peekPrevious() const + \fn template QHashIterator::Item QHashIterator::peekPrevious() const Returns the previous item without moving the iterator. @@ -1274,8 +1396,8 @@ \sa hasPrevious(), previous(), peekNext() */ -/*! \fn QMutableMapIterator::Item QMutableMapIterator::peekPrevious() const - \fn QMutableHashIterator::Item QMutableHashIterator::peekPrevious() const +/*! \fn template QMutableMapIterator::Item QMutableMapIterator::peekPrevious() const + \fn template QMutableHashIterator::Item QMutableHashIterator::peekPrevious() const Returns the previous item without moving the iterator. @@ -1288,8 +1410,8 @@ \sa hasPrevious(), previous(), peekNext() */ -/*! \fn const T &QMapIterator::value() const - \fn const T &QHashIterator::value() const +/*! \fn template const T &QMapIterator::value() const + \fn template const T &QHashIterator::value() const Returns the value of the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), @@ -1303,8 +1425,8 @@ */ /*! - \fn const T &QMutableMapIterator::value() const - \fn const T &QMutableHashIterator::value() const + \fn template const T &QMutableMapIterator::value() const + \fn template const T &QMutableHashIterator::value() const Returns the value of the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), @@ -1318,8 +1440,8 @@ */ /*! - \fn T &QMutableMapIterator::value() - \fn T &QMutableHashIterator::value() + \fn template T &QMutableMapIterator::value() + \fn template T &QMutableHashIterator::value() \overload Returns a non-const reference to the value of @@ -1327,10 +1449,10 @@ of the traversal functions. */ -/*! \fn const Key &QMapIterator::key() const - \fn const Key &QHashIterator::key() const - \fn const Key &QMutableMapIterator::key() const - \fn const Key &QMutableHashIterator::key() const +/*! \fn template const Key &QMapIterator::key() const + \fn template const Key &QHashIterator::key() const + \fn template const Key &QMutableMapIterator::key() const + \fn template const Key &QMutableHashIterator::key() const Returns the key of the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), @@ -1343,10 +1465,10 @@ \sa value() */ -/*! \fn bool QMapIterator::findNext(const T &value) - \fn bool QHashIterator::findNext(const T &value) - \fn bool QMutableMapIterator::findNext(const T &value) - \fn bool QMutableHashIterator::findNext(const T &value) +/*! \fn template bool QMapIterator::findNext(const T &value) + \fn template bool QHashIterator::findNext(const T &value) + \fn template bool QMutableMapIterator::findNext(const T &value) + \fn template bool QMutableHashIterator::findNext(const T &value) Searches for \a value starting from the current iterator position forward. Returns \c true if a (key, value) pair with value \a value @@ -1359,10 +1481,10 @@ \sa findPrevious() */ -/*! \fn bool QMapIterator::findPrevious(const T &value) - \fn bool QHashIterator::findPrevious(const T &value) - \fn bool QMutableMapIterator::findPrevious(const T &value) - \fn bool QMutableHashIterator::findPrevious(const T &value) +/*! \fn template bool QMapIterator::findPrevious(const T &value) + \fn template bool QHashIterator::findPrevious(const T &value) + \fn template bool QMutableMapIterator::findPrevious(const T &value) + \fn template bool QMutableHashIterator::findPrevious(const T &value) Searches for \a value starting from the current iterator position backward. Returns \c true if a (key, value) pair with value \a value @@ -1375,8 +1497,8 @@ \sa findNext() */ -/*! \fn void QMutableMapIterator::remove() - \fn void QMutableHashIterator::remove() +/*! \fn template void QMutableMapIterator::remove() + \fn template void QMutableHashIterator::remove() Removes the last item that was jumped over using one of the traversal functions (next(), previous(), findNext(), findPrevious()). @@ -1384,8 +1506,8 @@ \sa setValue() */ -/*! \fn void QMutableMapIterator::setValue(const T &value) - \fn void QMutableHashIterator::setValue(const T &value) +/*! \fn template void QMutableMapIterator::setValue(const T &value) + \fn template void QMutableHashIterator::setValue(const T &value) Replaces the value of the last item that was jumped over using one of the traversal functions with \a value. -- cgit v1.2.3