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=()も参照 。

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

イテレータをmap で操作するようにします。イテレータは、マップの先頭 (最初の項目の前) に設定されます。

toFront() およびtoBack() も参照 。

void QMapIterator::toFront()

イテレータをコンテナの先頭 (最初の項目の前) に移動します。

toBack() およびnext() も参照 。

void QMapIterator::toBack()

イテレータをコンテナの後ろ (最後の項目の後) に移動します。

toFront() およびprevious()も参照 。

bool QMapIterator::hasNext() const

イテレータの前に少なくとも 1 つの項目がある場合、つまりイテレータがコンテナの後ろにない場合はtrue を返し、そうでない場合はfalse を返す。

hasPrevious() およびnext()も参照 。

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

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

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

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

hasNext()、peekNext()、previous()も参照 。

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

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

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

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

hasNext()、next()、peekPrevious()も参照 。

bool QMapIterator::hasPrevious() const

イテレータの後ろに少なくとも1つの項目がある場合、つまりイテレータがコンテナの前面にない場合はtrue を返し、そうでない場合はfalse を返します。

hasNext() およびprevious()も参照 。

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

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

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

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

hasPrevious()、peekPrevious()、next()も参照 。

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

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

項目のキーを取得するには戻り値でkey() を呼び、値を取得するにはvalue() を呼びます。

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

hasPrevious()、previous()、peekNext()も参照 。

const T &QMapIterator::value() const

トラバーサル関数 (next()、previous()、findNext()、findPrevious()) のいずれかを使用してジャンプオーバーした最後の項目の値を返します。

next() またはfindNext() を呼び出した後、value() はpeekPrevious() と等価である。value().previous()またはfindPrevious()へのコールの後、value()はpeekNext()と等価である。value()。

key()も参照 。

const Key &QMapIterator::key() const

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

next() またはfindNext() を呼び出した後、key() はpeekPrevious() と等価である。key().previous()またはfindPrevious()へのコールの後、key()はpeekNext()と等価である。key()。

value()も参照 。

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()も参照のこと 。