QMutableHashIterator Class

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

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

QMutableHashIterator<QString, QString> i(hash);
while (i.hasNext()) {
    i.next();
    if (i.key() == i.value())
        i.remove();
}

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

QMutableHashIterator::QMutableHashIterator(QHash<Key, T> &hash)

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

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

bool QMutableHashIterator::findNext(const T &value)

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

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

bool QMutableHashIterator::hasNext() const

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

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

const Key &QMutableHashIterator::key() const

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

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

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

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

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

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

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

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

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

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

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

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

void QMutableHashIterator::remove()

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

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

void QMutableHashIterator::setValue(const T &value)

value を使用して、いずれかの探索関数によってスキップされた最後の項目の値を置き換えます。

トラバーサル関数には、next() およびfindNext() があります。

key()、value()、およびremove()も参照してください 。

void QMutableHashIterator::toBack()

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

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

void QMutableHashIterator::toFront()

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

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

const T &QMutableHashIterator::value() const

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

key() およびsetValue()も参照してください 。

T &QMutableHashIterator::value()

トラバーサル関数のいずれかを使用してスキップされた最後の項目の値への非const参照を返します。

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

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

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