Namespaces
Variants

std:: hash <std::basic_string>

From cppreference.net
C++
Strings library
std::basic_string
ヘッダーで定義 <string>
template < class A >
struct hash < std:: basic_string < char , std:: char_traits < char > , A >> ;
(1) (C++11以降)
template < class A >
struct hash < std:: basic_string < char16_t , std:: char_traits < char16_t > , A >> ;
(2) (C++11以降)
template < class A >
struct hash < std:: basic_string < char32_t , std:: char_traits < char32_t > , A >> ;
(3) (C++11以降)
template < class A >
struct hash < std:: basic_string < wchar_t , std:: char_traits < wchar_t > , A >> ;
(4) (C++11以降)
template < class A >
struct hash < std:: basic_string < char8_t, std:: char_traits < char8_t > , A >> ;
(5) (C++20以降)

様々な文字列クラスに対する std::hash のテンプレート特殊化は、ユーザーが文字列のハッシュ値を取得することを可能にします。

これらのハッシュは対応する std::basic_string_view クラスのハッシュと等しい： S がこれらの文字列型の1つであり、 SV が対応する文字列ビューの型であり、 s が型 S のオブジェクトである場合、 std:: hash < S > ( ) ( s ) == std:: hash < SV > ( ) ( SV ( s ) ) が成り立つ。

(C++17以降)

例

以下のコードは、文字列に対して使用されるハッシュ関数の出力例を示しています：

このコードを実行 
#include <functional>
#include <iostream>
#include <memory_resource>
#include <string>
#include <string_view>
using namespace std::literals;
int main()
{
    auto sv = "Stand back! I've got jimmies!"sv;
    std::string s(sv);
    std::pmr::string pmrs(sv); // use default allocator
    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 3705 C++11 カスタマイズされたアロケータを持つ std::basic_string に対するhashサポートが有効になっていなかった 有効化

関連項目

(C++11)
ハッシュ関数オブジェクト
(クラステンプレート)
(C++17) (C++17) (C++20) (C++17) (C++17)
文字列ビューのハッシュサポート
(クラステンプレート特殊化)