QMutableListIterator Class

メンバ関数ドキュメント

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

list を走査するためのイテレータを構築します。イテレータはリストの先頭 (最初の項目の前) に設定されます。

operator=()も参照 。

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

イテレータをlist で動作させる。イテレータはリストの先頭（最初の項目の前）に設定される。

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

void QMutableListIterator::toFront()

イテレータをコンテナの先頭（最初の項目の前）に移動する。

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

void QMutableListIterator::toBack()

イテレータをコンテナの後ろ（最後のアイテムの後）に移動します。

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

bool QMutableListIterator::hasNext() const

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

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

bool QMutableListIterator::hasPrevious() const

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

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

bool QMutableListIterator::findNext(const T &value)

現在のイテレータ位置から前方に向かってvalue を検索する。value が見つかればtrue を返し、見つからなければfalse を返す。

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

findPrevious()も参照 。

bool QMutableListIterator::findPrevious(const T &value)

現在のイテレータ位置から後方にvalue を検索する。value が見つかればtrue を返し、見つからなければ false を返す。

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

findNext()も参照のこと 。

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

トラバーサル関数の1つを使用してジャンプオーバーされた最後の項目の値をvalue で置き換える。

トラバーサル関数は、next()、previous()、findNext()、findPrevious() です。

例：

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

value()、remove()、insert()も参照 。

const T &QMutableListIterator::value() const

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

next() またはfindNext() を呼び出した後は、value() はpeekPrevious() と同じ。previous() またはfindPrevious() を呼び出した後は、value() はpeekNext() と同じ。

setValue()も参照 。

T &QMutableListIterator::value()

これはオーバーロードされた関数である。

トラバーサル関数のいずれかを使って最後にジャンプオーバーした項目の値への nononst リファレンスを返します。