std::hash(std::basic_string) — cppreference.com

Материал из cppreference.com

Определено в заголовочном файле `<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 <iostream>
#include <string>
#include <string_view>
#include <functional>
#include <memory_resource>
using namespace std::literals;
 
int main()
{
    auto sv = "Отойди! У меня есть Джимми!"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';
}

Возможный вывод:

11158872145337085299
11158872145337085299
11158872145337085299

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 3705	C++11	поддержка хэширования для std::basic_string с настроенными аллокаторами не была доступна	доступна

Смотрите также

Категории: