iterator Class
class QMultiHash::iteratorQMultiHash::iterator クラスは、QMultiHash 用の STL スタイルの非 const イテレータを提供します。さらに...
パブリック関数
| iterator() | |
| const Key & | key() const |
| T & | value() const |
| bool | operator!=(const QMultiHash<Key, T>::const_iterator &other) const |
| bool | operator!=(const QMultiHash<Key, T>::iterator &other) const |
| T & | operator*() const |
| QMultiHash<Key, T>::iterator & | operator++() |
| QMultiHash<Key, T>::iterator | operator++(int) |
| T * | operator->() const |
| bool | operator==(const QMultiHash<Key, T>::const_iterator &other) const |
| bool | operator==(const QMultiHash<Key, T>::iterator &other) const |
詳しい説明
QMultiHash<Key, T>::iterator は、QMultiHash を繰り返し処理し、特定のキーに関連付けられた値 (キーではない) を変更することができます。QMultiHash を反復処理したい場合は、QMultiHash::const_iterator を使用する必要があります。イテレータを使用してQMultiHash を変更する必要がない限り、constQMultiHash 以外でもQMultiHash::const_iterator を使用するのが一般的です。const イテレータのほうが若干高速で、コードの可読性も向上します。
デフォルトのQMultiHash::iterator コンストラクタは、初期化されていないイテレータを作成します。QMultiHash::begin （）、QMultiHash::end （）、QMultiHash::find （）のようなQMultiHash 関数を使用して初期化しなければなりません。以下は、ハッシュに格納されたすべての（キー、値）ペアを表示する典型的なループです：
QHash<QString, int> hash; hash.insert("January", 1); hash.insert("February", 2); ... hash.insert("December", 12); for (auto i = hash.cbegin(), end = hash.cend(); i != end; ++i) cout << qPrintable(key()) << ": " << i.value() << endl;
項目をキー順に並べるQMap とは異なり、QMultiHash は任意の順序で項目を格納する。
以下は、QMultiHash に格納されているすべての値を2ずつインクリメントする例である：
for (auto i = hash.begin(), end = hash.end(); i != end; ++i) i.value() += 2;
QMultiHash から要素を削除するには、erase_if(QMultiHash<Key, T> &map, Predicate pred)を使います：
複数のイテレータを同じハッシュに使用することができます。しかし、QHash （項目の挿入や削除）に対して直接行われる修正は、イテレータを無効にしてしまう可能性があることに注意してください。
ハッシュに項目を挿入したり、QHash::reserve() やQHash::squeeze() などのメソッドを呼び出したりすると、ハッシュを指すすべてのイテレータが無効になる可能性があります。イテレータは、QHash がその内部ハッシュ・テーブルを拡大/縮小する必要がない限り、有効であり続けることが保証される。再ハッシュ操作が発生した後にイテレータを使用すると、未定義の動作につながります。
長期間イテレータを保持する必要がある場合は、QHash ではなくQMultiMap を使用することをお勧めします。
警告： 暗黙的に共有されたコンテナ上のイテレータは、STLイテレータのようには動作しません。そのコンテナ上でイテレータがアクティブになっている間は、コンテナのコピーを避けるべきである。詳細については、暗黙の共有イテレータ問題を参照してください。
QMultiHash::const_iterator 、QMultiHash::key_iterator 、QMultiHash::key_value_iteratorも参照 。
メンバ関数ドキュメント
[noexcept] bool iterator::operator==(const QMultiHash<Key, T>::const_iterator &other) const
[noexcept] bool iterator::operator==(const QMultiHash<Key, T>::iterator &other) const
other がこのイテレータと同じ項目を指している場合はtrue を返し、そうでない場合はfalse を返す。
operator!=()も参照 。
[noexcept] bool iterator::operator!=(const QMultiHash<Key, T>::const_iterator &other) const
[noexcept] bool iterator::operator!=(const QMultiHash<Key, T>::iterator &other) const
other がこのイテレータと異なる項目を指している場合はtrue を返し、そうでない場合はfalse を返す。
operator==()も参照して ください。
[constexpr noexcept] iterator::iterator()
初期化されていないイテレータを構築します。
key()、value()、 operator++() などの関数を、初期化されていないイテレータで呼び出してはいけません。operator=() を使用して値を代入してから使用してください。
QMultiHash::begin() およびQMultiHash::end()も参照してください 。
[noexcept] const Key &iterator::key() const
現在の項目のキーを const 参照として返します。
QMultiHash::erase() の後にQMultiHash::insert() を呼び出すことで可能ですが、アイテムのキーをイテレータを通して変更する直接的な方法はありません。
value()も参照してください 。
[noexcept] T &iterator::value() const
現在の項目の値への変更可能な参照を返します。
例えば、代入の左辺で value() を使用することで、項目の値を変更することができます：
if (i.key() == "Hello") i.value() = "Bonjour";
[noexcept] T &iterator::operator*() const
現在の項目の値への変更可能な参照を返します。
value() と同じ。
key() も参照 。
[noexcept] QMultiHash<Key, T>::iterator &iterator::operator++()
接頭辞 ++ 演算子 (++i) は、イテレータをハッシュ内の次の項目に進め、新しい現在の項目へのイテレータを返します。
この関数をQMultiHash::end() で呼び出すと、未定義の結果になります。
[noexcept] QMultiHash<Key, T>::iterator iterator::operator++(int)
これはオーバーロードされた関数です。
postfix ++ 演算子 (i++) は、イテレータをハッシュ内の次の項目に進め、それ以前の現在の項目へのイテレータを返します。
[noexcept] T *iterator::operator->() const
現在の項目の値へのポインタを返します。
value()も参照 。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
