# std::hash (std::string, std::wstring, std::u16string, std::u32string, std::u8string, std::pmr::string, std::pmr::wstring, std::pmr::u16string, std::pmr::u32string, std::pmr::u8string)

< cpp‎ | string‎ | basic string

定义于头文件 `<string>` |  |
template<> struct hash<std::string>; template<> struct hash<std::wstring>; template<> struct hash<std::u16string>; template<> struct hash<std::u32string>; |  | (C++11 起)
template<> struct hash<std::pmr::string>; template<> struct hash<std::pmr::wstring>; template<> struct hash<std::pmr::u16string>; template<> struct hash<std::pmr::u32string>; |  | (C++17 起)
template<> struct hash<std::u8string>; template<> struct hash<std::pmr::u8string>; |  | (C++20 起)

std::hash 对各种字符串类的模板特化允许用户获得字符串的哈希。

这些哈希等于对应 std::basic_string_view 类的哈希：若 `S` 是这些字符串类型之一， `SV` 是对应的字符串视图类型，而 `s` 是 `S` 类型的对象，则 std::hash<S>()(s) == std::hash<SV>()(SV(s)) 。 | (C++17 起)

### 示例

下列代码显示 string 上使用的散列函数的一种可能输出：

    #include <iostream>
    #include <string>
    #include <string_view>
    #include <functional>
    #include <memory_resource>
    using namespace std::literals;

    int main()
    {
        auto sv = "Stand back! I've got jimmies!"sv;
        std::string s(sv);
        std::pmr::string pmrs(sv); // 使用默认分配器

        std::cout << std::hash<std::string_view>{}(sv) << '\n';
        std::cout << std::hash<std::string>{}(s) << '\n';
        std::cout << std::hash<std::pmr::string>{}(pmrs) << '\n';
    }

可能的输出：

    3544599705012401047
    3544599705012401047
    3544599705012401047

### 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR | 应用于 | 出版时的行为 | 正确行为
--- | --- | --- | ---
LWG 2978 | C++17 | 未启用 std::pmr::string 与其类似物的散列支持 | 已启用

### 参阅

hash (C++11) | 散列函数对象 (类模板)
std::hash<std::string_view>std::hash<std::wstring_view>std::hash<std::u8string_view>std::hash<std::u16string_view>std::hash<std::u32string_view> (C++17)(C++17)(C++20)(C++17)(C++17) | string_view 的散列支持 (类模板特化)