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=()も参照してください 。

bool QHashIterator::findNext(const T &value)

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

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

bool QHashIterator::hasNext() const

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

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

const Key &QHashIterator::key() const

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

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

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

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

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

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

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

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

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

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

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

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

void QHashIterator::toBack()

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

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

void QHashIterator::toFront()

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

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

const T &QHashIterator::value() const

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

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

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

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

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