QMutableListIterator Class

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

QMutableListIterator::QMutableListIterator(QList<T> &list)

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

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

bool QMutableListIterator::findNext(const T &value)

現在のイテレータの位置から前方に向かって「value 」を検索します。value が見つかった場合はtrue を返し、見つからなかった場合はfalse を返します。

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

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

bool QMutableListIterator::findPrevious(const T &value)

現在のイテレータの位置から過去に向かって、value を検索します。value が見つかった場合はtrue を返し、見つからなかった場合はfalseを返します。

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

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

bool QMutableListIterator::hasNext() const

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

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

bool QMutableListIterator::hasPrevious() const

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

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

void QMutableListIterator::insert(const T &value)

現在のイテレータの位置に `value ` を挿入します。呼び出し後、イテレータは挿入された項目の直後に位置します。

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

T &QMutableListIterator::next()

次の要素への参照を返し、イテレータを1つ分進めます。

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

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

T &QMutableListIterator::peekNext() const

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

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

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

T &QMutableListIterator::peekPrevious() const

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

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

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

T &QMutableListIterator::previous()

前の要素への参照を返し、イテレータを1つ前の位置に移動します。

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

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

void QMutableListIterator::remove()

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

例：

QMutableListIterator<int> i(list);
while (i.hasNext()) {
    int val = i.next();
    if (val < -32768 || val > 32767)
        i.remove();
}

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

void QMutableListIterator::setValue(const T &value) const

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

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

例：

QMutableListIterator<double> i(list);
while (i.hasNext()) {
    double val = i.next();
    i.setValue(std::sqrt(val));
}

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

void QMutableListIterator::toBack()

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

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

void QMutableListIterator::toFront()

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

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

const T &QMutableListIterator::value() const

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

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

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

T &QMutableListIterator::value()

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

QMutableListIterator<T> &QMutableListIterator::operator=(QList<T> &list)

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

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