std::hash<std::optional>

< cpp‎ | utility‎ | optional

在标头 `<optional>` 定义
template< class T > struct hash<std::optional<T>>;		(C++17 起)

std::hash 对 std::optional 类的模板特化允许用户获得 optional 对象所含值的散列值。

若启用了 std::hash<std::remove_const_t<T>>，则启用特化 std::hash<optional<T>>，反之禁用它。

在启用时，对于含值的 std::optional<T> 类型对象 o，std::hash<std::optional<T>>()(o) 求值 std::hash<std::remove_const_t<T>>()(*o)。对于不含值的 optional，未指定散列值。

此特化的成员函数不保证 noexcept，因为底层类型的散列可能有抛出。

模板形参

T - optional 对象所含值的类型

示例

#include <iostream>
#include <optional>
#include <string>
#include <unordered_set>
 
using namespace std::literals;
 
int main()
{
    using OptStr = std::optional<std::string>;
 
    // hash<optional> 令 unordered_set 可以使用
    std::unordered_set<OptStr> s =
    {
        "ABC"s, "abc"s, std::nullopt, "def"s
    };
 
    for (const auto& o : s)
        std::cout << o.value_or("(null)") << '\t' << std::hash<OptStr>{}(o) << '\n';
}

可能的输出：

def     11697390762615875584
(null)  18446744073709548283
abc     3663726644998027833
ABC     11746482041453314842

参阅

hash

(C++11)

散列函数对象
(类模板)