QMutableMapIterator Class
template <typename Key, typename T> class QMutableMapIteratorQMutableMapIteratorクラスは、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 で操作するようにします。イテレータは、マップの先頭 (最初の項目の前) に設定されます。
void QMutableMapIterator::toFront()
イテレータをコンテナの先頭 (最初の項目の前) に移動します。
void QMutableMapIterator::toBack()
イテレータをコンテナの後ろ (最後の項目の後) に移動します。
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
を返します。
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()。
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() です。
©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。