std::hash<std::variant>

定义于头文件 <variant>。

template< class... Types >
struct hash<std::variant<Types...>>;    // (since C++17)

std::hash 对 std::variant 模板的模板特化允许用户获取 variant 对象的哈希值。

当 std::hash<std::remove_const_t<Types>>... 中的每个特化都启用时，特化 std::hash<std::variant<Types...>> 被启用（参见 std::hash），否则被禁用。

此特化的成员函数不保证是 noexcept。

模板参数

Types - variant 对象支持的替代类型

备注

与 std::hash<std::optional> 不同，variant 的哈希通常不等于所包含值的哈希；这使得区分持有相同值但作为不同替代的 std::variant<int, int> 成为可能。

示例

#include <iostream>
#include <string>
#include <variant>
 
using Var = std::variant<int, int, int, std::string>;
 
template<unsigned I>
void print(Var const& var)
{
    std::cout << "get<" << var.index() << "> = "
              << std::get<I>(var)
              << "\t" "# = "
              << std::hash<Var>{}(var) << '\n';
}
 
int main()
{
    Var var;
    std::get<0>(var) = 2020;
    print<0>(var);
    var.emplace<1>(2023);
    print<1>(var);
    var.emplace<2>(2026);
    print<2>(var);
    var = "C++";
    print<3>(var);
}

可能结果

get<0> = 2020   # = 2020
get<1> = 2023   # = 2024
get<2> = 2026   # = 2028
get<3> = C++    # = 15518724754199266859