QHash Class

相关非成员

[since 6.1] template <typename Key, typename T, typename Predicate> qsizetype erase_if(QHash<Key, T> &hash, Predicate pred)

删除散列hash 中谓词pred 返回 true 的所有元素。

该函数支持使用QHash<Key, T>::iterator 类型参数或std::pair<const Key &, T &> 类型参数的谓词。

如果有，则返回已删除元素的数量。

此函数在 Qt 6.1 中引入。

[constexpr noexcept, since 6.5] template <typename Enum, std::enable_if_t<std::is_enum_v<Enum>, bool> = true> size_t qHash(Enum key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.5 中引入。

[noexcept] size_t qHash(QDate key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(ulong key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(ushort key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept, since 6.0] size_t qHash(wchar_t key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[noexcept] size_t qHash(QLatin1StringView key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept, since 6.0] size_t qHash(QPoint key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[noexcept] size_t qHash(QTime key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept, since 6.9] template <typename T, std::enable_if_t<std::is_same_v<T, bool>, bool> > size_t qHash(T key, size_t seed)

返回key 的哈希值，使用seed 作为计算的种子。

该函数在 Qt 6.9 中引入。

[constexpr noexcept] size_t qHash(char key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept, since 6.0] size_t qHash(char16_t key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[constexpr noexcept, since 6.0] size_t qHash(char32_t key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[constexpr noexcept, since 6.0] size_t qHash(char8_t key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[noexcept] size_t qHash(const QBitArray &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept] size_t qHash(const QByteArray &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(const QChar key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

size_t qHash(const QDateTime &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept(...)] template <typename Key, typename T> size_t qHash(const QHash<Key, T> &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

qHash() 必须支持Key 和T 类型。

[noexcept(...)] template <typename T> size_t qHash(const QSet<T> &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

qHash() 必须支持T 类型。

哈希值与key 中元素的顺序无关，也就是说，包含相同元素的集合的哈希值相同。

[noexcept] size_t qHash(const QString &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[since 6.0] size_t qHash(const QTypeRevision &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[noexcept] size_t qHash(const QUrl &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

size_t qHash(const QVersionNumber &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept] template <typename T> size_t qHash(const T *key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept(...)] template <typename T1, typename T2> size_t qHash(const std::pair<T1, T2> &key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

qHash() 必须支持T1 和T2 类型。

[noexcept] size_t qHash(double key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept] size_t qHash(float key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(int key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(long key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept] size_t qHash(long double key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept, since 6.8] size_t qHash(qint128 key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.8 中引入。

[constexpr noexcept] size_t qHash(qint64 key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept, since 6.8] size_t qHash(quint128 key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.8 中引入。

[constexpr noexcept] size_t qHash(quint64 key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(short key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(signed char key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept, since 6.0] size_t qHash(std::nullptr_t key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

此函数在 Qt 6.0 中引入。

[constexpr noexcept] size_t qHash(uchar key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[constexpr noexcept] size_t qHash(uint key, size_t seed = 0)

返回key 的哈希值，使用seed 作为计算的种子。

[noexcept] size_t qHashBits(const void *p, size_t len, size_t seed = 0)

返回p 指向的大小为len 的内存块的哈希值，并使用seed 作为计算的种子。

该函数仅用于为您自己的自定义类型实现qHash() 功能。例如，下面是为 std::vector<int> 实现qHash() 重载的方法：

inline size_t qHash(const std::vector<int> &key, size_t seed = 0)
{
    if (key.empty())
        return seed;
    else
        return qHashBits(&key.front(), key.size() * sizeof(int), seed);
}

这利用了 std::vector 连续布局数据的特性。如果情况并非如此，或者所包含的类型有填充，则应使用qHashRange() 代替。

需要重申的是，qHashBits() 的实现与 Qt XML 提供的qHash() 重载一样，随时都可能发生变化。在不同的 Qt 版本中，qHashBits() 都会给出相同的结果（对于相同的输入），这一点绝不能依赖。

另请参阅 qHashRange() 和qHashRangeCommutative()。

[constexpr noexcept(...), since 6.0] template <typename... T> size_t qHashMulti(size_t seed, const T &... args)

返回args 的哈希值，使用seed 作为计算的种子，对每个元素连续应用qHash() 并将哈希值合并为一个哈希值。

请注意，参数的顺序很重要。如果顺序不重要，请使用qHashMultiCommutative() 代替。如果是对原始内存进行散列，请使用qHashBits() ；如果是对一个范围进行散列，请使用qHashRange() 。

提供此函数是为了方便您为自己的自定义类型实现qHash() 。例如，下面是为类Employee 实现qHash() 重载的方法：

#ifndef EMPLOYEE_H
#define EMPLOYEE_H

class Employee
{
public:
    Employee() {}
    Employee(const QString &name, QDate dateOfBirth);
    ...

private:
    QString myName;
    QDate myDateOfBirth;
};

inline bool operator==(const Employee &e1, const Employee &e2)
{
    return e1.name() == e2.name()
           && e1.dateOfBirth() == e2.dateOfBirth();
}

inline size_t qHash(const Employee &key, size_t seed)
{
    return qHashMulti(seed, key.name(), key.dateOfBirth());
}

#endif // EMPLOYEE_H

此函数在 Qt 6.0 中引入。

另请参阅 qHashMultiCommutative 和qHashRange 。

[constexpr noexcept(...), since 6.0] template <typename... T> size_t qHashMultiCommutative(size_t seed, const T &... args)

通过对每个元素连续应用qHash() 并将哈希值合并为单一哈希值，返回args 的哈希值，并使用seed 作为计算的种子。

参数的顺序并不重要。如果顺序很重要，请使用qHashMulti() 代替，因为它可能产生更好的散列质量。如果是对原始内存进行散列，请使用qHashBits() ；如果是对一个范围进行散列，请使用qHashRange() 。

提供此函数是为了方便您为自己的自定义类型实现qHash() 。

此函数在 Qt 6.0 中引入。

另请参阅 qHashMulti 和qHashRange 。

[noexcept(...)] template <typename InputIterator> size_t qHashRange(InputIterator first, InputIterator last, size_t seed = 0)

返回范围 [first,last) 的哈希值，计算时使用seed 作为种子，对每个元素连续应用qHash() 并将哈希值合并为一个哈希值。

此函数的返回值取决于范围内元素的顺序。也就是说

{0, 1, 2}

和

{1, 2, 0}

散列值不同。如果顺序并不重要，例如对于哈希表，请使用qHashRangeCommutative() 代替。如果要对原始内存进行散列，请使用qHashBits() 。

该函数仅用于为您自己的自定义类型实现qHash() 功能。例如，下面是为 std::vector<int> 实现qHash() 重载的方法：

inline size_t qHash(const std::vector<int> &key, size_t seed = 0)
{
    return qHashRange(key.begin(), key.end(), seed);
}

需要重申的是，qHashRange() 的实现--就像 Qt XML 提供的qHash() 重载一样--可能随时发生变化。在不同的 Qt XML 版本中，qHashRange() 将给出相同的结果（对于相同的输入），即使元素类型的qHash() 会给出相同的结果，您也不能依赖这一事实。

另请参见 qHashBits() 和qHashRangeCommutative()。

[noexcept(...)] template <typename InputIterator> size_t qHashRangeCommutative(InputIterator first, InputIterator last, size_t seed = 0)

通过对每个元素连续应用qHash() 并将哈希值合并为一个哈希值，返回范围 [first,last) 的哈希值，计算时使用seed 作为种子值。

此函数的返回值与范围内元素的顺序无关。也就是说

{0, 1, 2}

和

{1, 2, 0}

散列值相同。如果顺序很重要，例如对于向量和数组，请使用qHashRange() 代替。如果要对原始内存进行散列，请使用qHashBits()。

该函数仅用于为您自己的自定义类型实现qHash() 功能。例如，下面是为 std::unordered_set<int> 实现qHash() 重载的方法：

inline size_t qHash(const std::unordered_set<int> &key, size_t seed = 0)
{
    return qHashRangeCommutative(key.begin(), key.end(), seed);
}

需要重申的是，qHashRangeCommutative() 的实现--就像 Qt XML 提供的qHash() 重载一样--可能随时发生变化。在不同的 Qt XML 版本中，qHashRangeCommutative() 会给出相同的结果（对于相同的输入），即使元素类型的qHash() 会给出相同的结果，您也不能依赖这一事实。

另请参见 qHashBits() 和qHashRange()。

[noexcept] bool operator!=(const QHash<Key, T> &lhs, const QHash<Key, T> &rhs)

如果lhs 哈希值不等于rhs 哈希值，则返回true ；否则返回false 。

如果两个哈希值包含相同的（键、值）对，则视为相等。

此函数要求值类型实现operator==() 。

另请参见 operator==()。

template <typename Key, typename T> QDataStream &operator<<(QDataStream &out, const QHash<Key, T> &hash)

将散列hash 写入流out 。

该函数要求键和值类型实现operator<<() 。

另请参阅 序列化 Qt 数据类型。

[noexcept] bool operator==(const QHash<Key, T> &lhs, const QHash<Key, T> &rhs)

如果lhs 哈希值等于rhs 哈希值，则返回true ；否则返回false 。

如果两个哈希值包含相同的（键、值）对，则视为相等。

此函数要求值类型实现operator==() 。

另请参见 operator!=()。

template <typename Key, typename T> QDataStream &operator>>(QDataStream &in, QHash<Key, T> &hash)

将哈希值从in 流读入hash 。

该函数要求键和值类型实现operator>>() 。

另请参阅 序列化 Qt 数据类型。