QHashIterator Class

QHash<int, QWidget *> hash;
...
QHashIterator<int, QWidget *> i(hash);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

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

メンバ関数ドキュメント

QHashIterator::QHashIterator(const QHash<Key, T> &hash)

hash を走査するイテレータを構築する。イテレータはハッシュの先頭（最初の項目の前）に設定されます。

operator=()も参照 。

QHashIterator<Key, T> &QHashIterator::operator=(const QHash<Key, T> &hash)

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

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

void QHashIterator::toFront()

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

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

void QHashIterator::toBack()

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

toFront()も参照 。

bool QHashIterator::hasNext() const

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

next()も参照 。

const Key &QHashIterator::key() const

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

value()も参照 。

bool QHashIterator::findNext(const T &value)

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

呼び出し後、value が見つかった場合、イテレータは一致する項目の直後に配置される。そうでない場合、イテレータはコンテナの後ろに配置される。

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

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

戻り値に対してkey() をコールしてアイテムのキーを取得し、value() をコールして値を取得する。

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

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

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

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

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

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

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

const T &QHashIterator::value() const

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

key()も参照 。