QMultiMap Class

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

[default] QMultiMap::QMultiMap()

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

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

[explicit, since 6.0] QMultiMap::QMultiMap(QMap<Key, T> &&other)

other が共有されている場合、other のコピーとしてマルチマップを構築します。そうでない場合は、other から要素を移動させてマルチマップを構築します。

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

[explicit, since 6.0] QMultiMap::QMultiMap(const QMap<Key, T> &other)

other のコピーとしてマルチマップを構築します。

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

[explicit] QMultiMap::QMultiMap(const std::multimap<Key, T> &other)

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

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

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

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

[explicit] QMultiMap::QMultiMap(std::multimap<Key, T> &&other)

other からデータを取得して、マルチマップを構築します。

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

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

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

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

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

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

QMultiMapのインスタンスをmove-constructし、other が指していたのと同じオブジェクトを指すようにします。

[implicit] QMultiMap::~QMultiMap()

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

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

QMultiMap<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も参照してください 。

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

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

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

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

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

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

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

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

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

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

void QMultiMap::clear()

マルチマップからすべての項目を削除します。

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

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

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

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

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

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

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

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

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

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

find() およびQMultiMap::constFind(const Key &key, const T &value)も参照してください 。

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

マップ内の、キーが `key ` で値が `value ` である項目を指すイテレータを返します。

マップにそのような項目が含まれていない場合、この関数はconstEnd() を返します。

QMap::constFind()も参照してください 。

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

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

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

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

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

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

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

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

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

bool QMultiMap::contains(const Key &key, const T &value) const

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

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

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

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

contains() およびQMultiMap::count(const Key &key, const T &value)も参照してください 。

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

キーが `key `、値が `value` である項目の数を返します。

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

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

size() と同じです。

bool QMultiMap::empty() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

マップにキー `key` を持つ項目が複数存在する場合、この関数は最も新しく挿入された値を指すイテレータを返します。他の値には、イテレータをインクリメントすることでアクセスできます。例えば、同じキーを持つすべての項目を反復処理するコードは次のようになります:

auto i = multimap.find("plenty");
while (i != multimap.end() && i.key() == "plenty") {
    cout << i.value() << endl;
    ++i;
}

// better:
auto [i, end] = multimap.equal_range("plenty");
while (i != end) {
    cout << i.value() << endl;
    ++i;
}

関連項目： constFind()、value()、values()、lowerBound()、およびupperBound()。

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

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

マップ内の、指定されたkey およびvalue を持つ項目を指すconstイテレータを返します。

マップにそのような項目が含まれていない場合、この関数は `end()` を返します。

マップに指定された `key` を持つ項目が複数ある場合、この関数は、最後に挿入された値を指す const イテレータを返します。

T &QMultiMap::first()

マルチマップの最初の値、つまり最も小さいキーにマッピングされた値への参照を返します。この関数は、マルチマップが空ではないことを前提としています。

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

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

const T &QMultiMap::first() const

const Key &QMultiMap::firstKey() const

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

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

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

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

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

マップに同じキーを持つ項目がすでに存在する場合、この関数は単に新しい項目を作成します。（この動作は、既存の項目の値を上書きする `replace()` とは異なります。）

QMultiMap 重複するキーを許可し、項目はキーの昇順で格納されます。キーが重複する場合、値は挿入順の逆順で格納されます（最も最近に挿入された値が先頭になります）。

新しい要素を指すイテレータを返します。

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

QMultiMap<Key, T>::iterator QMultiMap::insert(QMultiMap<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 が間違っている場合は、それは無視され、通常の挿入が行われます。

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

マップに同じキーを持つ項目がすでに存在する場合、この関数は単に新しい項目を作成します。

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

新しい要素を指すイテレータを返します。

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

bool QMultiMap::isEmpty() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QList<Key> QMultiMap::keys() const

マルチマップ内のすべてのキーを昇順で含むリストを返します。マルチマップ内で複数回出現するキーは、リスト内でも複数回出現します。

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

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

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

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

値「value 」に関連付けられたすべてのキーを昇順で含むリストを返します。

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

T &QMultiMap::last()

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

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

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

const T &QMultiMap::last() const

const Key &QMultiMap::lastKey() const

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

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

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

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

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

例：

QMultiMap<int, QString> multimap;
multimap.insert(1, "one");
multimap.insert(5, "five");
multimap.insert(5, "five (2)");
multimap.insert(10, "ten");

multimap.lowerBound(0);      // returns iterator to (1, "one")
multimap.lowerBound(1);      // returns iterator to (1, "one")
multimap.lowerBound(2);      // returns iterator to (5, "five")
multimap.lowerBound(5);      // returns iterator to (5, "five")
multimap.lowerBound(6);      // returns iterator to (10, "ten")
multimap.lowerBound(10);     // returns iterator to (10, "ten")
multimap.lowerBound(999);    // returns end()

マップにキー `key` を持つ項目が複数存在する場合、この関数は最後に挿入された値を指すイテレータを返します。他の値には、イテレータをインクリメントすることでアクセスできます。例えば、同じキーを持つすべての項目を反復処理するコードは次のようになります:

QMap<QString, int> multimap;
//...
QMap<QString, int>::const_iterator i = multimap.lowerBound("HDR");
QMap<QString, int>::const_iterator upperBound = multimap.upperBound("HDR");
while (i != upperBound) {
    cout << i.value() << endl;
    ++i;
}

関連項目: upperBound() およびfind()。

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

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

マルチマップから、キー「key 」を持つすべての項目を削除します。削除された項目の数を返します。

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

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

マルチマップから、キーが「key 」、値が「value 」であるすべての項目を削除します。削除された項目の数を返します。

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

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

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

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

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

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

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

QMultiMap<Key, T>::iterator QMultiMap::replace(const Key &key, const T &value)

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

キーがkey であるアイテムがすでに存在する場合、そのアイテムの値はvalue に置き換えられます。

キーkey を持つ項目が複数ある場合、最後に挿入された項目の値がvalue に置き換えられます。

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

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

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

マルチマップ内の（キー、値）のペアの数を返します。

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

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

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

T QMultiMap::take(const Key &key)

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

マルチマップにその項目が存在しない場合、この関数はデフォルトコンストラクタで生成された値を返します。マップ内にkey に対応する項目が複数存在する場合、最も最近挿入されたものだけが削除され、返されます。

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

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

std::multimap<Key, T> QMultiMap::toStdMultiMap() const &

QMultiMap に相当する STL マルチマップを返します。

QList<Key> QMultiMap::uniqueKeys() const

マップ内のすべてのキーを昇順で並べたリストを返します。マップ内に複数回出現するキーは、返されるリストには1回だけ含まれます。

QMultiMap<Key, T> &QMultiMap::unite(QMultiMap<Key, T> &&other)

other マップ内のすべての項目を、このマップに移動します。両方のマップに共通するキーがある場合、結果のマップにはそのキーが複数回含まれます。

other が共有されている場合は、代わりに項目がコピーされます。

QMultiMap<Key, T> &QMultiMap::unite(const QMultiMap<Key, T> &other)

other マップ内のすべての項目を、このマップに挿入します。両方のマップに共通するキーがある場合、結果として得られるマップにはそのキーが複数回含まれます。

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

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

例：

QMultiMap<int, QString> multimap;
multimap.insert(1, "one");
multimap.insert(5, "five");
multimap.insert(5, "five (2)");
multimap.insert(10, "ten");

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

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

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

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

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

マルチマップにキー「key 」を持つ項目が含まれていない場合、この関数は「defaultValue 」を返します。defaultValue が指定されていない場合、この関数はデフォルト構築された値を返します。マルチマップ内に「key 」に対応する項目が複数存在する場合、最後に挿入された項目の値が返されます。

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

QList<T> QMultiMap::values() const

マップ内のすべての値を、キーの昇順で並べたリストを返します。1つのキーに複数の値が関連付けられている場合、その値はすべてリストに含まれ、最後に挿入された値だけが含まれるわけではありません。

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

QList<T> QMultiMap::values(const Key &key) const

キー `key` に関連付けられたすべての値を、最も新しく挿入されたものから最も古いものへと順に並べたリストを返します。

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

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

other をこのQMultiMap インスタンスに移動・割り当てます。

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

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