QMultiMapIterator Class

QMultiMap<int,QWidget*>multimap;
//...
QMultiMapIterator<int,QWidget*>i(multimap);
while(i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

QMultiMapIterator<int,QWidget*>i(multimap);
i.toBack();
while(i.hasPrevious()) {
    i.previous();
    qDebug() << i.key() << ": " << i.value();
}

QMultiMapIterator<int,QWidget*>i(multimap);
while(i.findNext(widget)) {
    qDebug() << "Found widget " << widget << " under key "
           <<i.key();
}

メンバ関数のドキュメント

QMultiMapIterator::QMultiMapIterator(const QMultiMap<Key, T> &map)

map を走査するためのイテレータを作成します。このイテレータは、マップの先頭（最初の要素の前）に位置するように設定されます。

operator=()も参照してください 。

bool QMultiMapIterator::findNext(const T &value)

現在のイテレータ位置から前方に向かって、value を検索します。値がvalue である (key, value) のペアが見つかった場合はtrue を返し、見つからなかった場合はfalse を返します。

呼び出し後、value が見つかった場合は、イテレータは一致した項目の直後に位置付けられます。見つからなかった場合は、イテレータはコンテナの末尾に位置付けられます。

findPrevious()も参照してください 。

bool QMultiMapIterator::findPrevious(const T &value)

現在のイテレータ位置から過去に向かって、value を検索します。値がvalue である (key, value) のペアが見つかった場合はtrue を返し、見つからなかった場合はfalse を返します。

呼び出し後、value が見つかった場合は、イテレータは一致する項目の直前に位置付けられます。見つからなかった場合は、イテレータはコンテナの先頭に位置付けられます。

findNext()も参照してください 。

bool QMultiMapIterator::hasNext() const

イテレータの先方に少なくとも1つの要素が存在する場合、つまりイテレータがコンテナの末尾にない場合は、true を返します。それ以外の場合は、false を返します。

hasPrevious() およびnext()も参照してください 。

bool QMultiMapIterator::hasPrevious() const

イテレータの先頭より後ろに少なくとも1つの要素が存在する場合、つまりイテレータがコンテナの先頭にあるわけではない場合は、true を返します。それ以外の場合は、false を返します。

hasNext() およびprevious()も参照してください 。

const Key &QMultiMapIterator::key() const

トラバーサル関数（next()、previous()、findNext()、findPrevious()）のいずれかを使用してスキップされた最後の項目のキーを返します。

next() またはfindNext() の呼び出し後は、key() はpeekPrevious() と同等になります。key()。previous() またはfindPrevious() の呼び出し後は、key() は peekNext() と同等になります。key()。

value()も参照してください 。

QMultiMapIterator<Key, T>::Item QMultiMapIterator::next()

次の項目を返し、イテレータを1つ進めます。

戻り値に対して `key()` を呼び出すと項目のキーを取得でき、`value()` を呼び出すと値を取得できます。

コンテナの末尾にあるイテレータに対してこの関数を呼び出すと、未定義の結果となります。

hasNext()、peekNext()、およびprevious()も参照してください 。

QMultiMapIterator<Key, T>::Item QMultiMapIterator::peekPrevious() const

イテレータを移動させることなく、前の項目を返します。

戻り値に対してkey()を呼び出すと項目のキーを取得でき、value()を呼び出すと値を取得できます。

コンテナの先頭にあるイテレータに対してこの関数を呼び出すと、定義されていない結果になります。

hasPrevious()、previous()、およびpeekNext()も参照してください 。

QMultiMapIterator<Key, T>::Item QMultiMapIterator::previous()

前の項目を返し、イテレータを1つ前の位置に移動します。

返り値に対してkey()を呼び出すと項目のキーを取得でき、value()を呼び出すと値を取得できます。

コンテナの先頭にあるイテレータに対してこの関数を呼び出すと、未定義の結果となります。

hasPrevious()、peekPrevious()、およびnext()も参照してください 。

void QMultiMapIterator::toBack()

イテレータをコンテナの末尾（最後の要素の直後）に移動します。

toFront() およびprevious()も参照してください 。

void QMultiMapIterator::toFront()

イテレータをコンテナの先頭（最初の要素の前）に移動します。

toBack() およびnext()も参照してください 。

const T &QMultiMapIterator::value() const

トラバーサル関数（next()、previous()、findNext()、findPrevious()）のいずれかを使用してスキップされた最後の項目の値を返します。

next() またはfindNext() の呼び出し後、value() はpeekPrevious() と同等になります。value()。previous() またはfindPrevious() の呼び出し後、value() は peekNext() と同等になります。value()。

key()も参照してください 。

QMultiMapIterator<Key, T> &QMultiMapIterator::operator=(const QMultiMap<Key, T> &map)

イテレータが `map` 上で動作するようにします。イテレータはマップの先頭（最初の要素の前）に位置するように設定されます。

toFront() およびtoBack()も参照してください 。