std::hash<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 がこれらの文字列型のいずれかであり、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++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時間ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行処理サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
技術仕様書
シンボルインデックス
外部ライブラリ

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)	文字列ビューのハッシュサポート (クラステンプレート特殊化)

ja.cppreference.net

Namespaces

Variants

std::hash<std::basic_string>

例

不具合報告

関連項目