QMultiHash Class

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

コンテナに新しい要素を挿入する。この新しい要素は、args を引数としてインプレースで作成されます。

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

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

insertも参照してください 。

コンテナに新しい要素を挿入する。この新しい要素は、args を引数としてインプレースで構築される。

ハッシュ内に同じキーを持つ項目が既に存在する場合、その項目の値はargs から構築された値で置き換えられます。

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

replace およびemplaceも参照のこと 。

key に関連付けられた値を返す。

ハッシュにkey の項目がない場合、この関数はdefaultValue を返し、このパラメータが指定されていない場合はデフォルトの値を返す。

ハッシュ内にkey の項目が複数ある場合は、最近挿入された項目の値が返されます。

value にマップされた最初のキーを返す。 ハッシュにvalue にマップされた項目がない場合、defaultKey を返し、このパラメータが与えられていない場合はデフォルトで構成されたキーを返す。

QMultiHash の内部データ構造は、値ではなくキーによる高速検索に最適化されているため、この関数は遅い（線形時間）。

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

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

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

このようにして得られるキーと値は、どちらもハッシュ内のものへの参照であることに注意してください。具体的には、値を変更するとハッシュ自体が変更されます。

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

QKeyValueIteratorも参照して ください。

[noexcept] QMultiHash::QMultiHash()

空のハッシュを構築する。

[explicit] QMultiHash::QMultiHash(const QHash<Key, T> &other)

other (QHash または QMultiHash) のコピーを構築します。

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

イニシャライザーリストlist の各要素のコピーでマルチハッシュを構築する。

template <typename InputIterator> QMultiHash::QMultiHash(InputIterator begin, InputIterator end)

イテレータ範囲 [begin,end] 内の各要素のコピーでマルチハッシュを構築します。範囲によって反復される要素は、first とsecond のデータ・メンバを持つオブジェクト（std::pair のように、それぞれKey とT に変換可能）でなければなりません。あるいは、反復子はkey() とvalue() のメンバ関数を持ち、それぞれKey に変換可能なキーとT に変換可能な値を返さなければなりません。

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

ハッシュの最初の項目を指すSTL 形式のイテレータを返します。

constBegin() およびend()も参照 。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::begin() const

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

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cbegin() const

ハッシュの最初の項目を指す、STL 形式のイテレータを返します。

begin() およびcend()も参照 。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cend() const

ハッシュの最後の項目の後にある架空の項目を指す、STL 形式のイテレータを返します。

cbegin() およびend()も参照のこと 。

[noexcept(...)] void QMultiHash::clear()

ハッシュからすべての項目を削除し、ハッシュが使用していたすべてのメモリを解放する。

remove()も参照のこと 。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constBegin() const

ハッシュの最初の項目を指す、STL 形式のイテレータを返します。

begin() およびconstEnd()も参照 。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constEnd() const

ハッシュの最後の項目の後にある架空の項目を指す、STL 形式のイテレータを返します。

constBegin() およびend()も参照のこと 。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constFind(const Key &key, const T &value) const

ハッシュ内のkey とvalue を持つ項目を指すイテレータを返す。

ハッシュにそのような項目がない場合、この関数はconstEnd() を返します。

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueBegin() const

ハッシュの最初のエントリを指す、STL 形式のイテレータを返します。

keyValueBegin()も参照 。

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueEnd() const

ハッシュの最後のエントリの後の架空のエントリを指すSTL 形式のイテレータを返します。

constKeyValueBegin()も参照 。

[noexcept] bool QMultiHash::contains(const Key &key, const T &value) const

ハッシュにkey とvalue の項目が含まれていればtrue を返し、そうでなければfalse を返す。

contains()も参照 。

[noexcept] qsizetype QMultiHash::count(const Key &key, const T &value) const

key およびvalue を持つ項目の数を返します。

count()も参照 ください。

[noexcept] QMultiHash<Key, T>::iterator QMultiHash::end()

ハッシュの最後の項目の後にある架空の項目を指すSTL 形式のイテレータを返します。

begin() およびconstEnd()も参照のこと 。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::end() const

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

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

key の下に格納されている値[first, second) の範囲を区切るイテレータのペアを返す。範囲が空の場合、両方のイテレータはend() に等しくなります。

[noexcept] std::pair<QMultiHash<Key, T>::const_iterator, QMultiHash<Key, T>::const_iterator> QMultiHash::equal_range(const Key &key) const

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

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

key valueハッシュにそのような項目がない場合、この関数はend() を返す。

ハッシュにkey とvalue を持つ複数の項目が含まれる場合、返されるイテレータは最近挿入された項目を指します。

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::find(const Key &key, const T &value) const

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

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

key と値value を持つ新しい項目を挿入する。

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

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

replace()も参照 。

[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyBegin() const

ハッシュの最初のキーを指す、STL 形式のイテレータを返します。

keyEnd()も参照 。

[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyEnd() const

ハッシュの最後のキーに続く架空の項目を指す、STL 形式のイテレータを返します。

keyBegin()も参照 。

[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueBegin()

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

keyValueEnd()も参照 。

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueBegin() const

ハッシュの最初のエントリを指す、STL 形式のイテレータを返します。

keyValueEnd()も参照 。

[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueEnd()

ハッシュの最後のエントリの後の架空のエントリを指すSTL 形式のイテレータを返します。

keyValueBegin()も参照 。

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueEnd() const

ハッシュの最後のエントリの後の架空のエントリを指す、STL 形式のイテレータを返します。

keyValueBegin()も参照 。

QList<Key> QMultiHash::keys() const

ハッシュ内のすべてのキーを含むリストを、任意の順番で返します。ハッシュ内で複数回出現するキーは、リスト内でも複数回出現します。

この順番は、values() で使用される順番と同じであることが保証される。

この関数は、線形時間で新しいリストを作成する。keyBegin() からkeyEnd() を繰り返し実行することで、時間とメモリの浪費を避けることができる。

values() およびkey()も参照の こと。

qsizetype QMultiHash::remove(const Key &key)

ハッシュからkey を持つすべての項目を削除します。削除した項目の数を返します。

remove()も参照 ください。

qsizetype QMultiHash::remove(const Key &key, const T &value)

ハッシュからkey と値value を持つすべての項目を削除します。削除された項目の数を返します。

remove()も参照 。

[since 6.1] template <typename Predicate> qsizetype QMultiHash::removeIf(Predicate pred)

述語pred が真を返す全ての要素をマルチハッシュから削除する。

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

もしあれば、削除された要素の数を返します。

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

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

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

key と値value を持つ新しい項目を挿入する。

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

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

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

insert()も参照のこと 。

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

このマルチハッシュをother と交換する。この操作は非常に高速で、失敗することはない。

T QMultiHash::take(const Key &key)

ハッシュからkey の項目を削除し、その項目に関連付けられた値を返します。

その項目がハッシュ内に存在しない場合、この関数は単にデフォルトの値を返します。ハッシュ内にkey の項目が複数ある場合は、最近挿入されたものだけが削除されます。

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

remove()も参照のこと 。

QList<Key> QMultiHash::uniqueKeys() const

マップ内のすべてのキーを含むリストを返す。マップ内で複数回出現するキーは、返されるリスト内で一度だけ出現します。

keys() およびvalues()も参照 。

[since 6.0] QMultiHash<Key, T> &QMultiHash::unite(const QHash<Key, T> &other)

other ハッシュ内のすべての項目をこのハッシュに挿入し、このハッシュへの参照を返します。

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

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

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

other ハッシュのすべての項目をこのハッシュに挿入し、このハッシュへの参照を返します。

insert()も参照 。

QList<T> QMultiHash::values() const

ハッシュ内のすべての値を任意の順番で含むリストを返します。キーが複数の値に関連付けられている場合は、 最近挿入された値だけでなくすべての値がリストに含まれることになります。

この順序は、keys() で使用される順序と同じであることが保証される。

この関数は、線形時間で新しいリストを作成する。keyValueBegin() からkeyValueEnd() を繰り返し実行することで、時間とメモリの浪費を避けることができる。

keys() およびvalue()も参照の こと。

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

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

最近挿入されたものから最近挿入されなかったものまで、key に関連付けられたすべての値のリストを返す。

count() およびinsert()も参照 。

QMultiHash<Key, T> QMultiHash::operator+(const QMultiHash<Key, T> &other) const

other のすべての項目に加え、このハッシュのすべての項目を含むハッシュを返します。 キーが両方のハッシュに共通の場合、結果のハッシュにはそのキーが複数回含まれます。

operator+=()も参照 。

QMultiHash<Key, T> &QMultiHash::operator+=(const QMultiHash<Key, T> &other)

other ハッシュのすべての項目をこのハッシュに挿入し、このハッシュへの参照を返す。

unite() およびinsert()も参照 。

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

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

ハッシュにkey を持つ項目がない場合、この関数はデフォルトで構成された値を key を持つハッシュに挿入し、その参照を返します。

ハッシュにkey を持つ複数の項目が含まれる場合、この関数は最も最近挿入された値への参照を返します。

insert() およびvalue()も参照 。