QMap::iterator Class

class QMap::iterator

QMap::iterator クラスは、QMap に対してSTLスタイルの非constイテレータを提供します。詳細...

パブリック型

iterator_category

パブリック関数

	iterator()
const Key &	key() const
T &	value() const
T &	operator*() const
QMap<Key, T>::iterator &	operator++()
QMap<Key, T>::iterator	operator++(int)
QMap<Key, T>::iterator &	operator--()
QMap<Key, T>::iterator	operator--(int)
T *	operator->() const

bool	operator!=(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)
bool	operator==(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

詳細な説明

QMap<Key, T>::iterator を使用すると、QMap を反復処理し、特定のキーの下に格納されている値（キー自体は変更不可）を変更することができます。 constQMap を反復処理したい場合は、QMap::const_iterator を使用する必要があります。イテレータを通じてQMap を変更する必要がない限り、非 constQMap に対してもQMap::const_iterator を使用するのが一般的なベストプラクティスです。const イテレータはわずかに高速であり、コードの可読性を向上させることができます。

デフォルトのQMap::iterator コンストラクタは、初期化されていないイテレータを作成します。反復処理を開始する前に、QMap::begin()、QMap::end()、またはQMap::find()などのQMap 関数を使用して、イテレータを初期化する必要があります。以下は、マップに格納されているすべての(key, value)ペアを出力する典型的なループです：

QMap<QString, int> map;
map.insert("January", 1);
map.insert("February", 2);
//...
map.insert("December", 12);

for (auto i = map.cbegin(), end = map.cend(); i != end; ++i)
    cout << qPrintable(i.key()) << ": " << i.value() << endl;

QHash は項目を任意の順序で格納するのに対し、QMap は項目をキー順に格納します。

以下は、QMap に格納されているすべての値を2ずつ増やす例です：

for (auto i = map.begin(), end = map.end(); i != end; ++i)
    i.value() += 2;

QMap から要素を削除するには、erase_if （QMap<Key, T> &map, Predicate pred）を使用できます:

erase_if(map, [](const QMap<QString, int>::iterator it) { return it.value() > 10; });

同じマップに対して複数のイテレータを使用できます。マップに項目を追加しても、既存のイテレータは有効なままです。マップから項目を削除すると、削除された項目を指すイテレータはダングリング・イテレータになります。

警告： 暗黙的に共有されるコンテナ上のイテレータは 、STLのイテレータとまったく同じように動作するわけではありません。そのコンテナ上でイテレータがアクティブな間は、コンテナのコピーを避けるべきです。詳細については、「暗黙的な共有によるイテレータの問題」を参照してください。

関連項目： QMap::const_iterator 、QMap::key_iterator 、およびQMap::key_value_iterator 。

メンバ型のドキュメント

`[alias]` iterator::iterator_category

このイテレータが双方向イテレータであることを示す、std::bidirectional_iterator_tagの同義語。

メンバ関数のドキュメント

`[default]` iterator::iterator()

初期化されていないイテレータを生成します。

key()、value()、およびoperator++() などの関数は、初期化されていないイテレータに対して呼び出してはなりません。使用する前に、operator=() を使用して値を代入してください。

QMap::begin() およびQMap::end()も参照してください 。

const Key &iterator::key() const

現在の項目のキーをconst参照として返します。

イテレータを通じて項目のキーを直接変更する方法はありませんが、QMap::erase() を呼び出した後にQMap::insert() を呼び出すことで変更することは可能です。

value()も参照してください 。

T &iterator::value() const

現在の項目の値への、変更可能な参照を返します。

代入文の左辺で value() を使用することで、項の値を変更できます。例：

if (i.key() == "Hello")
    i.value() = "Bonjour";

key() およびoperator*()も参照してください 。

T &iterator::operator*() const

現在の項目の値への、変更可能な参照を返します。

value() と同じです。

key()も参照してください 。

QMap<Key, T>::iterator &iterator::operator++()

プレフィックス演算子 `++ ` (++i) は、イテレータをマップ内の次の要素へと進め、新しい現在の要素へのイテレータを返します。

QMap::end() に対してこの関数を呼び出すと、未定義の結果となります。

operator--()も参照してください 。

QMap<Key, T>::iterator iterator::operator++(int)

後置演算子 `++ `（i++ ）は、イテレータをマップ内の次の項目へと進め、直前に現在位置にあった項目へのイテレータを返します。

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

QMap<Key, T>::iterator &iterator::operator--()

プレフィックス演算子 `-- ` (--i) は、その直前の要素を現在の要素とし、新しい現在の要素を指すイテレータを返します。

QMap::begin() に対してこの関数を呼び出すと、未定義の結果となります。

operator++()も参照してください 。

QMap<Key, T>::iterator iterator::operator--(int)

後置演算子 `-- ` (i--) は、直前の要素を現在の要素として設定し、直前に現在の要素だった要素を指すイテレータを返します。

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

T *iterator::operator->() const

現在の項目の値へのポインタを返します。

value()も参照してください 。

QMap::iterator Class

パブリック型

パブリック関数

詳細な説明

メンバ型のドキュメント

`[alias]` iterator::iterator_category

メンバ関数のドキュメント

`[default]` iterator::iterator()

const Key &iterator::key() const

T &iterator::value() const

T &iterator::operator*() const

QMap<Key, T>::iterator &iterator::operator++()

QMap<Key, T>::iterator iterator::operator++(int)

QMap<Key, T>::iterator &iterator::operator--()

QMap<Key, T>::iterator iterator::operator--(int)

T *iterator::operator->() const

関連する非メンバー関数

bool operator!=(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

bool operator==(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

QMap::iterator Class

パブリック型

パブリック関数

関連する非メンバー

詳細な説明

メンバ型のドキュメント

[alias] iterator::iterator_category

メンバ関数のドキュメント

[default] iterator::iterator()

const Key &iterator::key() const

T &iterator::value() const

T &iterator::operator*() const

QMap<Key, T>::iterator &iterator::operator++()

QMap<Key, T>::iterator iterator::operator++(int)

QMap<Key, T>::iterator &iterator::operator--()

QMap<Key, T>::iterator iterator::operator--(int)

T *iterator::operator->() const

関連する非メンバー関数

bool operator!=(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

bool operator==(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

`[alias]` iterator::iterator_category

`[default]` iterator::iterator()