QMap Class

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

[default] QMap::QMap()

空のマップを作成します。

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

[explicit] QMap::QMap(const std::map<Key, T> &other)

other のコピーを作成します。

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

QMap::QMap(std::initializer_list<std::pair<Key, T>> list)

初期化リスト `list` に含まれる各要素のコピーを使用して、マップを構築します。

[explicit] QMap::QMap(std::map<Key, T> &&other)

other から移動してマップを構築します。

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

[implicit] QMap::QMap(const QMap<Key, T> &other)

other のコピーを作成します。

QMapは暗黙的に共有されているため、この操作は定数時間で実行されます。これにより、関数からQMapを返す処理が非常に高速になります。共有されているインスタンスが変更された場合、そのインスタンスはコピーされます（コピー・オン・ライト）。この処理には線形時間がかかります。

operator=も参照してください 。

[implicit] QMap::QMap(QMap<Key, T> &&other)

QMapのインスタンスを動的に生成します。

[implicit] QMap::~QMap()

マップを破棄します。マップ内の値への参照、およびこのマップに対するすべての反復子は無効になります。

このマップをキー/値のペアとして反復処理できる範囲オブジェクトを返します。たとえば、この範囲オブジェクトは、構造化バインディング宣言と組み合わせて、範囲ベースの for ループで使用できます。

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

for (auto [key, value] : map.asKeyValueRange()) {
    cout << qPrintable(key) << ": " << value << endl;
    --value; // convert to JS month indexing
}

この方法で取得されるキーと値は、いずれもマップ内の要素への参照であることに注意してください。具体的には、値を変更するとマップ自体が変更されます。

これらの関数は Qt 6.4 で導入されました。

QKeyValueIteratorも参照してください 。

QMap<Key, T>::iterator QMap::begin()

マップの最初の要素を指すSTL形式のイテレータを返します。

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

QMap<Key, T>::const_iterator QMap::begin() const

QMap<Key, T>::const_iterator QMap::cbegin() const

マップの最初の要素を指す、STL スタイルのconstイテレータを返します。

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

QMap<Key, T>::const_iterator QMap::cend() const

マップの最後の要素の直後に位置する仮想の要素を指す、STL スタイルのconstイテレータを返します。

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

void QMap::clear()

マップからすべてのアイテムを削除します。

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

QMap<Key, T>::const_iterator QMap::constBegin() const

マップの最初の要素を指す、STL スタイルのconstイテレータを返します。

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

QMap<Key, T>::const_iterator QMap::constEnd() const

マップの最後の要素の直後に位置する仮想の要素を指す、STL スタイルのconstイテレータを返します。

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

QMap<Key, T>::const_iterator QMap::constFind(const Key &key) const

マップ内のキー「key 」を持つ項目を指す const イテレータを返します。

マップにキー `key` を持つ項目が含まれていない場合、この関数は `constEnd()` を返します。

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

QMap<Key, T>::const_key_value_iterator QMap::constKeyValueBegin() const

マップの最初のエントリを指す、STL スタイルのconstイテレータを返します。

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

QMap<Key, T>::const_key_value_iterator QMap::constKeyValueEnd() const

マップの最後のエントリの直後に位置する仮想のエントリを指す、STL スタイルのconstイテレータを返します。

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

bool QMap::contains(const Key &key) const

マップにキー `key` を持つ項目が含まれている場合は `true ` を返し、そうでない場合は `false` を返します。

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

QMap<Key, T>::size_type QMap::count(const Key &key) const

キー「key 」に関連付けられた項目の数を返します。

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

QMap<Key, T>::size_type QMap::count() const

size() と同じです。

bool QMap::empty() const

この関数は、STLとの互換性を確保するために提供されています。これは `isEmpty()` と同等であり、マップが空の場合は true を返し、それ以外の場合は false を返します。

QMap<Key, T>::iterator QMap::end()

マップの最後の要素の後に存在する架空の要素を指す、STL スタイルのイテレータを返します。

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

QMap<Key, T>::const_iterator QMap::end() const

std::pair<QMap<Key, T>::iterator, QMap<Key, T>::iterator> QMap::equal_range(const Key &key)

key に格納されている値の範囲[first, second) を区切るイテレータのペアを返します。

std::pair<QMap<Key, T>::const_iterator, QMap<Key, T>::const_iterator> QMap::equal_range(const Key &key) const

QMap<Key, T>::iterator QMap::erase(QMap<Key, T>::const_iterator pos)

イテレータ `pos ` が指す (キー, 値) のペアをマップから削除し、マップ内の次の項目へのイテレータを返します。

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

[since 6.0] QMap<Key, T>::iterator QMap::erase(QMap<Key, T>::const_iterator first, QMap<Key, T>::const_iterator last)

イテレータ範囲 [first,last) が指す (キー, 値) のペアをマップから削除します。削除された最後の要素の直後に続くマップ内の項目へのイテレータを返します。

この関数は Qt 6.0 で導入されました。

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

QMap<Key, T>::iterator QMap::find(const Key &key)

マップ内のキー「key 」を持つ項目を指すイテレータを返します。

マップにキー「key 」を持つ項目が含まれていない場合、この関数はend()を返します。

constFind()、value()、values()、lowerBound()、およびupperBound()も参照してください 。

QMap<Key, T>::const_iterator QMap::find(const Key &key) const

T &QMap::first()

マップ内の最初の値、つまり最も小さいキーに対応付けられた値への参照を返します。この関数は、マップが空ではないことを前提としています。

非共有モードの場合（または const バージョンが呼び出された場合）、これは定数時間で実行されます。

last()、firstKey()、およびisEmpty()も参照してください 。

const T &QMap::first() const

const Key &QMap::firstKey() const

マップ内の最小のキーへの参照を返します。この関数は、マップが空ではないことを前提としています。

この関数の実行時間は定数時間です。

lastKey()、first()、keyBegin()、およびisEmpty()も参照してください 。

void QMap::insert(QMap<Key, T> &&map)

map にあるすべての項目を、このマップに移動します。

両方のマップに共通するキーがある場合、その値はmap に保存されている値に置き換えられます。

map が共有されている場合は、代わりにアイテムがコピーされます。

void QMap::insert(const QMap<Key, T> &map)

map 内のすべての項目を、このマップに挿入します。

両方のマップに共通するキーがある場合、その値はmap に格納されている値に置き換えられます。

QMap<Key, T>::iterator QMap::insert(const Key &key, const T &value)

キー「key 」、値「value 」を持つ新しい項目を挿入します。

キーkey を持つ項目がすでに存在する場合、その項目の値はvalue に置き換えられます。

既存のキーを持つキー/値のペアを挿入すると、既存の値が上書きされます。

新規または更新された要素を指すイテレータを返します。

QMap<Key, T>::iterator QMap::insert(QMap<Key, T>::const_iterator pos, const Key &key, const T &value)

キー「key 」、値「value 」を持つ新しい項目を挿入し、挿入先を示すヒント「pos 」を指定します。

constBegin() がヒントとして使用された場合、key がマップ内のどのキーよりも小さいことを示し、constEnd() が使用された場合は、key がマップ内のどのキーよりも（厳密に）大きいことを示します。 それ以外の場合、ヒントは次の条件を満たす必要があります。(pos - 1).key() <key <= pos.key()。ヒントpos が間違っている場合は無視され、通常の挿入が行われます。

キーkey を持つ項目がすでに存在する場合、その項目の値はvalue に置き換えられます。

ヒントが正しく、マップが共有されていない場合、挿入は償却定数時間で実行されます。

ソート済みのデータからマップを作成する場合、constBegin() を使用して最大のキーを最初に挿入する方が、constEnd() を使用してソート順に挿入するよりも高速です。これは、constEnd() - 1（ヒントが有効かどうかを確認するために必要）に対数時間かかるためです。

注：ヒントの使用には注意が必要です。古い共有インスタンスからのイテレータを指定するとクラッシュする可能性があるほか、マップとpos マップの両方が静かに破損してしまうリスクもあります。

新しい／更新された要素を指すイテレータを返します。

bool QMap::isEmpty() const

マップに要素が含まれていない場合は `true ` を返し、それ以外の場合は `false` を返します。

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

Key QMap::key(const T &value, const Key &defaultKey = Key()) const

値が `value` である最初のキーを返します。マップに値が `value` である項目が含まれていない場合は、`defaultKey ` を返します。defaultKey が指定されていない場合、この関数はデフォルト構築されたキーを返します。

QMap の内部データ構造は、値による検索ではなくキーによる高速な検索用に最適化されているため、この関数の実行速度は遅くなる可能性があります（線形時間）。

value() およびkeys()も参照してください 。

QMap<Key, T>::key_iterator QMap::keyBegin() const

マップ内の最初のキーを指す、STL スタイルのconstイテレータを返します。

keyEnd() およびfirstKey()も参照してください 。

QMap<Key, T>::key_iterator QMap::keyEnd() const

マップの最後のキーの後に存在する架空の項目を指す、STL スタイルのconstイテレータを返します。

keyBegin() およびlastKey()も参照してください 。

QMap<Key, T>::key_value_iterator QMap::keyValueBegin()

マップの最初のエントリを指すSTL形式のイテレータを返します。

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

QMap<Key, T>::const_key_value_iterator QMap::keyValueBegin() const

マップの最初のエントリを指す、STL スタイルのconstイテレータを返します。

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

QMap<Key, T>::key_value_iterator QMap::keyValueEnd()

マップの最後のエントリの直後に位置する仮想のエントリを指す、STL スタイルのイテレータを返します。

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

QMap<Key, T>::const_key_value_iterator QMap::keyValueEnd() const

マップの最後のエントリの直後に位置する仮想のエントリを指す、STL スタイルのconstイテレータを返します。

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

QList<Key> QMap::keys() const

マップ内のすべてのキーを昇順で並べたリストを返します。

この順序は、values() で使用される順序と同じであることが保証されています。

この関数は、線形時間で新しいリストを作成します。これに伴う時間およびメモリの使用は、keyBegin() からkeyEnd() へ反復処理を行うことで回避できます。

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

QList<Key> QMap::keys(const T &value) const

値 `value ` に関連付けられたすべてのキーを昇順で格納したリストを返します。

QMap の内部データ構造は、値ではなくキーによる高速な検索用に最適化されているため、この関数の実行は遅くなる可能性があります（線形時間）。

T &QMap::last()

マップ内の最後の値、つまり最大のキーに対応付けられた値への参照を返します。この関数は、マップが空ではないことを前提としています。

非共有モードの場合（または const バージョンが呼び出された場合）、これは定数時間で実行されます。

first()、lastKey()、およびisEmpty()も参照してください 。

const T &QMap::last() const

const Key &QMap::lastKey() const

マップ内の最大のキーへの参照を返します。この関数は、マップが空ではないことを前提としています。

この関数の実行時間は定数時間です。

firstKey()、last()、keyEnd()、およびisEmpty()も参照してください 。

QMap<Key, T>::iterator QMap::lowerBound(const Key &key)

マップ内でキーkey を持つ最初の項目を指すイテレータを返します。マップにキーkey を持つ項目が含まれていない場合、この関数は、そのキーより大きい値を持つ最も近い項目へのイテレータを返します。

upperBound() およびfind()も参照してください 。

QMap<Key, T>::const_iterator QMap::lowerBound(const Key &key) const

QMap<Key, T>::size_type QMap::remove(const Key &key)

マップから、キー `key ` を持つすべての項目を削除します。削除された項目の数を返します。マップにそのキーが存在する場合は 1、存在しない場合は 0 を返します。

clear() およびtake()も参照してください 。

[since 6.1] template <typename Predicate> QMap<Key, T>::size_type QMap::removeIf(Predicate pred)

pred という述語が true を返すすべての要素をマップから削除します。

この関数は、QMap<Key, T>::iterator 型の引数、またはstd::pair<const Key &, T &> 型の引数を受け取る述語をサポートしています。

削除された要素がある場合は、その数を返します。

この関数は Qt 6.1 で導入されました。

clear() およびtake()も参照してください 。

QMap<Key, T>::size_type QMap::size() const

マップに含まれる (キー, 値) のペアの数を返します。

isEmpty() およびcount()も参照してください 。

[noexcept] void QMap::swap(QMap<Key, T> &other)

このマップを「other 」と入れ替えます。この操作は非常に高速で、失敗することはありません。

T QMap::take(const Key &key)

キー「key 」を持つ項目をマップから削除し、それに関連付けられた値を返します。

マップにその項目が存在しない場合、この関数はデフォルト構築された値を返すだけです。

戻り値を使用しない場合は、remove() の方が効率的です。

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

std::map<Key, T> QMap::toStdMap() const &

この `QMap` と同等の STL マップを返します。

[since 6.0] std::map<Key, T> QMap::toStdMap() &&

この関数は Qt 6.0 で導入されました。

QMap<Key, T>::iterator QMap::upperBound(const Key &key)

マップ内のキーkey を持つ最後の項目の直後に続く項目を指すイテレータを返します。マップにキーkey を持つ項目が含まれていない場合、この関数は、そのキーよりも大きい値を持つ最も近い項目へのイテレータを返します。

例：

QMap<int, QString> map;
map.insert(1, "one");
map.insert(5, "five");
map.insert(10, "ten");

map.upperBound(0);      // returns iterator to (1, "one")
map.upperBound(1);      // returns iterator to (5, "five")
map.upperBound(2);      // returns iterator to (5, "five")
map.upperBound(10);     // returns end()
map.upperBound(999);    // returns end()

lowerBound() およびfind()も参照してください 。

QMap<Key, T>::const_iterator QMap::upperBound(const Key &key) const

T QMap::value(const Key &key, const T &defaultValue = T()) const

キー「key 」に関連付けられた値を返します。

マップにキー「key 」を持つ項目が含まれていない場合、この関数はdefaultValue を返します。defaultValue が指定されていない場合、この関数はデフォルト構築された値を返します。

key()、values()、contains()、およびoperator[]()も参照してください 。

QList<T> QMap::values() const

マップ内のすべての値を、キーの昇順で並べたリストを返します。

この関数は、線形時間で新しいリストを作成します。これに伴う時間とメモリの使用は、keyValueBegin() からkeyValueEnd() への反復処理を行うことで回避できます。

keys() およびvalue()も参照してください 。

[implicit] QMap<Key, T> &QMap::operator=(QMap<Key, T> &&other)

other をこのQMap インスタンスに割り当てます。

[implicit] QMap<Key, T> &QMap::operator=(const QMap<Key, T> &other)

このマップにother を割り当て、このマップへの参照を返します。

T &QMap::operator[](const Key &key)

キー「key 」に関連付けられた値を、変更可能な参照として返します。

マップにキー `key` を持つ項目が含まれていない場合、この関数はキー `key`を持つデフォルト構築された値をマップに挿入し、その参照を返します。

insert() およびvalue()も参照してください 。

T QMap::operator[](const Key &key) const

value() と同じです。