QMutableMapIterator Class

template <typename Key, typename T> class QMutableMapIterator

QMutableMapIteratorクラスは、QMap 、Javaスタイルの非定数イテレータを提供します。さらに...

Header: #include <QMutableMapIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

パブリック関数

QMutableMapIterator(QMap<Key, T> &map)
bool findNext(const T &value)
bool findPrevious(const T &value)
bool hasNext() const
bool hasPrevious() const
const Key &key() const
QMutableMapIterator<Key, T>::Item next()
QMutableMapIterator<Key, T>::Item peekNext() const
QMutableMapIterator<Key, T>::Item peekPrevious() const
QMutableMapIterator<Key, T>::Item previous()
void remove()
void setValue(const T &value)
void toBack()
void toFront()
const T &value() const
T &value()
QMutableMapIterator<Key, T> &operator=(QMap<Key, T> &map)

詳細説明

QMap にはJavaスタイルのイテレータと STLスタイルのイテレータの両方がある。STLスタイルのイテレータの方が効率的であり、そちらを優先すべきです。

QMutableMapIterator<Key, T> を使うと、QMap を繰り返し処理し、マップを修正することができます。マップを変更したくない(あるいは、QMap を const で指定したい)場合は、代わりに少し高速なQMapIterator を使用してください。

QMutableMapIteratorコンストラクタは、引数としてQMap 。構築後、イテレーターはマップの一番最初(最初のアイテムの前)に位置します。以下は、すべての要素を順次反復処理する方法です:

QMap<int, QWidget *> map;
...
QMutableMapIterator<int, QWidget *> i(map);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

next() 関数は、マップの次の項目を返し、イテレータを進める。key() とvalue() 関数は、最後にジャンプオーバーした項目のキーと値を返します。

STLスタイルのイテレータとは異なり、Javaスタイルのイテレータは、項目を直接指すのではなく、項目間を指す。next ()を最初に呼び出すと、イテレータは最初の項目と2番目の項目の間の位置に進み、最初の項目を返します。next ()を2回目に呼び出すと、イテレータは2番目の項目と3番目の項目の間の位置に進みます。

以下は、要素を逆順に反復処理する方法である:

QMutableMapIterator<int, QWidget *> i(map);
i.toBack();
while (i.hasPrevious()) {
    i.previous();
    qDebug() << i.key() << ": " << i.value();
}

特定の値の出現回数をすべて検索したい場合は、findNext ()またはfindPrevious ()をループ内で使用する。例えば

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

マップを繰り返しながら項目を削除したい場合は、remove ()を使用する。項目の値を変更する場合は、setValue() を使用します。

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

この例では、キーと値が同じ (key, value) のペアをすべて削除します。

与えられたマップ上でいつでもアクティブにできるのは、1つのミュータブル・イテレータだけです。さらに、イテレータがアクティブな間は(イテレータを通してではなく)マップに直接変更を加えてはいけません。イテレータが無効になり、未定義の動作につながる可能性があるからです。

QMapIterator およびQMap::iteratorも参照して ください。

メンバ関数ドキュメント

QMutableMapIterator::QMutableMapIterator(QMap<Key, T> &map)

map をトラバースするためのイテレータを構築する。イテレータはマップの先頭(最初の項目の前)に設定されます。

operator=()も参照

QMutableMapIterator<Key, T> &QMutableMapIterator::operator=(QMap<Key, T> &map)

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

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

void QMutableMapIterator::toFront()

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

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

void QMutableMapIterator::toBack()

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

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

bool QMutableMapIterator::hasNext() const

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

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

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

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

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

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

hasNext()、peekNext()、previous()も参照

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

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

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

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

hasNext()、next()、peekPrevious()も参照

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

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

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

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

hasNext()、next()、peekPrevious()も参照

bool QMutableMapIterator::hasPrevious() const

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

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

QMutableMapIterator<Key, T>::Item QMutableMapIterator::previous()

前の項目を返し、イテレータを 1 つ後ろに移動します。

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

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

hasPrevious()、peekPrevious()、next()も参照

QMutableMapIterator<Key, T>::Item QMutableMapIterator::peekPrevious() const

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

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

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

hasPrevious()、previous()、peekNext()も参照

const T &QMutableMapIterator::value() const

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

next() またはfindNext() を呼び出した後、value() はpeekPrevious() と等価である。value().previous()またはfindPrevious()へのコールの後、value()はpeekNext()と等価である。value()。

key() およびsetValue()も参照

T &QMutableMapIterator::value()

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

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

const Key &QMutableMapIterator::key() const

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

next() またはfindNext() を呼び出した後、key() はpeekPrevious() と等価である。key().previous()またはfindPrevious()へのコールの後、key()はpeekNext()と等価である。key()。

value()も参照

bool QMutableMapIterator::findNext(const T &value)

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

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

findPrevious()も参照のこと

bool QMutableMapIterator::findPrevious(const T &value)

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

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

findNext()も参照

void QMutableMapIterator::remove()

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

setValue()も参照

void QMutableMapIterator::setValue(const T &value)

トラバーサル関数のいずれかを使用してジャンプオーバーされた最後の項目の値をvalue に置き換えます。

走査関数は、next()、previous()、findNext()、findPrevious() です。

key()、value()、remove()も参照のこと

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。