QMutableMultiMapIterator Class
template <typename Key, typename T> class QMutableMultiMapIteratorQMutableMultiMapIterator クラスは、QMultiMap に対して Java スタイルの非定数イテレータを提供します。詳細...
| ヘッダー: | #include <QMutableMultiMapIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
パブリック関数
| QMutableMultiMapIterator(QMultiMap<Key, T> &map) | |
| bool | findNext(const T &value) |
| bool | findPrevious(const T &value) |
| bool | hasNext() const |
| bool | hasPrevious() const |
| const Key & | key() const |
| QMutableMultiMapIterator<Key, T>::Item | next() |
| QMutableMultiMapIterator<Key, T>::Item | peekNext() const |
| QMutableMultiMapIterator<Key, T>::Item | peekPrevious() const |
| QMutableMultiMapIterator<Key, T>::Item | previous() |
| void | remove() |
| void | setValue(const T &value) |
| void | toBack() |
| void | toFront() |
| const T & | value() const |
| T & | value() |
| QMutableMultiMapIterator<Key, T> & | operator=(QMultiMap<Key, T> &map) |
詳細な説明
QMultiMap Java スタイルのイテレータと STL スタイルのイテレータの両方を備えています。STL スタイルのイテレータの方が効率が高いため、そちらを優先して使用すべきです。テンプレートパラメータ `Key ` はマップのキー型を指定し、`T ` は値型を指定します。
QMutableMultiMapIterator<Key, T> を使用すると、QMultiMap を反復処理しながらマップを変更することができます。マップを変更したくない場合(またはQMultiMap が const である場合)は、代わりに、わずかに高速なQMultiMapIterator を使用してください。
QMutableMultiMapIteratorのコンストラクタは、QMultiMap を引数として受け取ります。生成後、イテレータはマップの先頭(最初の要素の前)に位置します。すべての要素を順次反復処理する方法は次のとおりです:
QMultiMap<int,QWidget*>multimap;
//...
QMutableMultiMapIterator<int,QWidget*>i(multimap);
while(i.hasNext()) {
i.next();
qDebug() << i.key() << ": " << i.value();
}next() 関数は、マップ内の次の要素を返し、イテレータを進めます。key() およびvalue() 関数は、スキップされた直前の要素のキーと値を返します。
STL スタイルのイテレータとは異なり、Java スタイルのイテレータは要素を直接指すのではなく、要素間の位置を指します。next() の最初の呼び出しは、イテレータを 1 番目と 2 番目の要素の間にある位置に進め、1 番目の要素を返します。next() の 2 回目の呼び出しは、イテレータを 2 番目と 3 番目の要素の間にある位置に進めます。以下同様です。
要素を逆順に反復処理する方法は次のとおりです:
QMutableMultiMapIterator<int,QWidget*>i(multimap);
i.toBack();
while(i.hasPrevious()) {
i.previous();
qDebug() << i.key() << ": " << i.value();
}特定の値がどこに現れるかをすべて検索したい場合は、ループ内で `findNext()` または `findPrevious()` を使用します。例:
QMutableMultiMapIterator<int,QWidget*>i(multimap);
while(i.findNext(widget)) {
qDebug() << "Found widget " << widget << " under key "
<<i.key();
}マップを反復処理しながら要素を削除したい場合は、remove() を使用してください。要素の値を変更したい場合は、setValue() を使用してください。
例:
QMutableMultiMapIterator<QString, QString> i(multimap);
while (i.hasNext()) {
i.next();
if (i.key() == i.value())
i.remove();
}この例では、キーと値が同じであるすべての (キー, 値) ペアを削除します。
特定のマップに対して、一度にアクティブにできる可変イテレータは1つだけです。さらに、イテレータがアクティブな間は(イテレータを介してではなく)マップに対して直接変更を行ってはなりません。そうすると、イテレータが無効になり、未定義の挙動を引き起こす恐れがあります。
QMultiMapIterator およびQMultiMap::iteratorも参照してください 。
メンバ関数のドキュメント
QMutableMultiMapIterator::QMutableMultiMapIterator(QMultiMap<Key, T> &map)
map を走査するためのイテレータを作成します。このイテレータは、マップの先頭(最初の要素の前)に位置するように設定されます。
operator=()も参照してください 。
bool QMutableMultiMapIterator::findNext(const T &value)
現在のイテレータ位置から前方に向かって、value を検索します。値がvalue である (key, value) のペアが見つかった場合はtrue を返し、見つからなかった場合はfalse を返します。
呼び出し後、value が発見された場合、イテレータは一致した項目の直後に位置付けられます。そうでない場合、イテレータはコンテナの末尾に位置付けられます。
findPrevious()も参照してください 。
bool QMutableMultiMapIterator::findPrevious(const T &value)
現在のイテレータ位置から過去に向かって、value を検索します。値がvalue である (key, value) のペアが見つかった場合はtrue を返し、見つからなかった場合はfalse を返します。
呼び出し後、value が見つかった場合は、イテレータは一致する項目の直前に位置付けられます。見つからなかった場合は、イテレータはコンテナの先頭に位置付けられます。
findNext()も参照してください 。
bool QMutableMultiMapIterator::hasNext() const
イテレータの先方に少なくとも1つの要素が存在する場合、つまりイテレータがコンテナの末尾にない場合は、true を返します。それ以外の場合は、false を返します。
hasPrevious() およびnext()も参照してください 。
bool QMutableMultiMapIterator::hasPrevious() const
イテレータの先頭より後ろに少なくとも1つの要素が存在する場合、つまりイテレータがコンテナの先頭にあるのではない場合、true を返します。それ以外の場合は、false を返します。
hasNext() およびprevious()も参照してください 。
const Key &QMutableMultiMapIterator::key() const
トラバーサル関数(next()、previous()、findNext()、findPrevious())のいずれかを使用してスキップされた最後の項目のキーを返します。
next() またはfindNext() を呼び出した後、key() はpeekPrevious() と同等になります。key()。previous() またはfindPrevious() を呼び出した後、key() はpeekNext() と同等になります。key()。
value()も参照してください 。
QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::next()
次の項目を返し、イテレータを1つ先へ進めます。
戻り値に対してkey()を呼び出すと項目のキーが取得でき、value()を呼び出すと値が取得できます。
コンテナの末尾にあるイテレータに対してこの関数を呼び出すと、未定義の結果となります。
hasNext()、peekNext()、およびprevious()も参照してください 。
QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::peekNext() const
イテレータを移動させることなく、次の項目への参照を返します。
戻り値に対してkey()を呼び出すと項目のキーが得られ、value()を呼び出すと値が得られます。
コンテナの末尾にあるイテレータに対してこの関数を呼び出すと、未定義の結果となります。
hasNext()、next()、およびpeekPrevious()も参照してください 。
QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::peekPrevious() const
イテレータを移動させることなく、直前の項目を返します。
戻り値に対してkey()を呼び出すと項目のキーが取得でき、value()を呼び出すと値が取得できます。
コンテナの先頭にあるイテレータに対してこの関数を呼び出すと、未定義の結果となります。
hasPrevious()、previous()、およびpeekNext()も参照してください 。
QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::previous()
前の項目を返し、イテレータを1つ前の位置に移動します。
返り値に対してkey()を呼び出すと項目のキーが取得でき、value()を呼び出すと値が取得できます。
コンテナの先頭にあるイテレータに対してこの関数を呼び出すと、定義されていない結果になります。
hasPrevious()、peekPrevious()、およびnext()も参照してください 。
void QMutableMultiMapIterator::remove()
トラバーサル関数(next()、previous()、findNext()、findPrevious())のいずれかを使用してスキップされた最後の項目を削除します。
setValue()も参照してください 。
void QMutableMultiMapIterator::setValue(const T &value)
value を使用して、いずれかのトラバーサル関数によってスキップされた最後の項目の値を置き換えます。
トラバーサル関数には、next()、previous()、findNext()、およびfindPrevious() があります。
key()、value()、およびremove()も参照してください 。
void QMutableMultiMapIterator::toBack()
イテレータをコンテナの末尾(最後の要素の直後)に移動します。
toFront() およびprevious()も参照してください 。
void QMutableMultiMapIterator::toFront()
イテレータをコンテナの先頭(最初の要素の前)に移動します。
const T &QMutableMultiMapIterator::value() const
トラバーサル関数(next()、previous()、findNext()、findPrevious())のいずれかを使用してスキップされた最後の項目の値を返します。
next() またはfindNext() を呼び出した後、value() はpeekPrevious() と同等になります。value()。previous() またはfindPrevious() を呼び出した後、value() はpeekNext() と同等になります。value()。
key() およびsetValue()も参照してください 。
T &QMutableMultiMapIterator::value()
トラバーサル関数のいずれかを使用してスキップされた最後の項目の値への非const参照を返します。
QMutableMultiMapIterator<Key, T> &QMutableMultiMapIterator::operator=(QMultiMap<Key, T> &map)
イテレータが `map` 上で動作するようにします。イテレータはマップの先頭(最初の要素の前)に位置するように設定されます。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.