QMultiHash类

成员函数文档

将新元素插入容器。新元素使用 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()

构建一个空的哈希表。

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

构造一个具有初始化列表中每个元素副本的多重哈希表。

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

构造一个包含迭代器范围 [begin, end) 中每个元素副本的多重哈希表。该范围所迭代的元素必须是具有 first 和 second 数据成员的对象（如 std::pair），可转换为 Key 和 T 分别；或者迭代器必须具有 key() 和 value() 成员函数，分别返回可转换为 Key 和 T 的键和值。

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

构建一个 other 的副本（可以是 QHash 或 QMultiHash）。

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

返回一个指向哈希簿中第一个项目的 STL-style iterator。

另请参阅constBegin() 和 end。

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

这是一个重载函数。

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

返回一个指向哈希簿中第一个项目的 const STL-style iterator。

另请参阅begin() 和 cend。

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

返回一个指向哈希簿中最后一个项目的后面的虚构项目的 const STL-style iterator。

另请参阅cbegin() 和 end。

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

从哈希表中删除所有项并释放它占用的所有内存。

另请参阅：remove()。

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

返回一个指向哈希簿中第一个项目的 const STL-style iterator。

另请参阅：begin() 和 constEnd()。

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

返回一个指向哈希簿中最后一个项目的后面的虚构项目的 const STL-style iterator。

另请参阅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

返回一个指向哈希表中第一个条目的 const STL-style 迭代器。

另请参阅：keyValueBegin()。

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

返回一个指向哈希表中最后一个条目之后的假想条目的 const STL-style 迭代器。

另请参阅：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-style 迭代器。

另请参阅：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-style iterator。

另请参阅keyEnd()。

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

返回一个指向哈希中最后一个键之后的一个虚构项的常量STL-style iterator。

另请参阅keyBegin()。

[无异常] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueBegin()

返回一个指向哈希中第一个条目的 STL样式迭代器。

另请参阅keyValueEnd。

[无异常] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueBegin() const

返回一个指向哈希表中第一个条目的 const STL-style 迭代器。

另请参阅keyValueEnd。

[无异常] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueEnd()

返回一个指向哈希中最后一项之后虚构条目的 STL样式迭代器。

另请参阅：keyValueBegin()。

[无异常] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueEnd() const

返回一个指向哈希表中最后一个条目之后的假想条目的 const STL-style 迭代器。

另请参阅：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()。

[自6.1起] 模板 <typename Predicate> qsizetype QMultiHash::removeIf(Predicate pred)

从多哈希中移除所有使谓词 pred 返回 true 的元素。

该函数支持接受类型为 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的新项。

如果已经存在具有 键 的项，那么该项的值将被 值 替换。

如果存在多个具有 键 的项，则将最近插入的项的值替换为 值。

返回一个指向新/更新元素的迭代器。

另请参阅 insert。

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

交换哈希 other 与此哈希。此操作非常快且从不失败。

T QMultiHash::take(const Key &key)

从哈希中删除具有 键 的项并返回与其关联的值。

如果该项不在哈希中，函数则简单地返回一个 默认构造的值。如果哈希中为 键 包含多个项，则只移除最近插入的一项。

如果您不使用返回值，则 remove() 更高效。

另请参阅：remove()。

QList<Key> QMultiHash::uniqueKeys() const

返回一个包含哈希中所有键的列表。哈希表中多次出现的键在返回的列表中只出现一次。

另请参阅 keys() 和 values。

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

将 other 哈希中的所有项插入到此哈希中，并返回对此哈希的引用。

另请参阅 insert。

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

将 other 哈希中的所有项插入到此哈希中，并返回对此哈希的引用。

该函数从 Qt 6.0 开始引入。

另请参阅 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

返回一个包含此哈希中所有项以及其他所有项的哈希。如果两个哈希共享同一个键，则结果哈希将包含该键多次。

另请参阅 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().