QMapIterator Class

QMap<int,QWidget*>map;
//...
QMapIterator<int,QWidget*>i(map);
while(i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

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

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

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

QMapIterator::QMapIterator(const QMap<Key, T> &map)

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

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

bool QMapIterator::findNext(const T &value)

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

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

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

bool QMapIterator::findPrevious(const T &value)

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

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

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

bool QMapIterator::hasNext() const

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

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

bool QMapIterator::hasPrevious() const

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

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

const Key &QMapIterator::key() const

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

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

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

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

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

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

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

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

QMapIterator<Key, T>::Item QMapIterator::peekNext() const

イテレータを移動させずに、次の項目を返します。

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

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

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

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

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

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

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

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

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

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

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

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

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

void QMapIterator::toBack()

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

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

void QMapIterator::toFront()

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

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

const T &QMapIterator::value() const

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

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

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

QMapIterator<Key, T> &QMapIterator::operator=(const QMap<Key, T> &map)

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

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