Пространства имён
Варианты
Действия

std::hash(std::basic_string)

Материал из cppreference.com
< cpp‎ | string‎ | basic string
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Строки
 
std::basic_string
Функции-элементы
(C++23)
Доступ к элементам
(DR*)
(DR*)
(C++17)
Итераторы
(DR*)
(DR*)
(DR*)
(DR*)
Ёмкость
(DR*)
Операции
(C++23)
(DR*)
(C++23)
(C++23)
(C++23)  
Поиск
(C++20)  
(C++20)
(C++23)
Константы
Правила вывода (C++17)
Функции, не являющиеся элементами
(C++14)
(C++20)(C++20)
Ввод/Вывод
Сравнение
(до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)
Числовые преобразования
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Вспомогательные классы
hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string>hash<std::u8string>
(C++11)  (C++11)(C++11)(C++11)(C++20)
hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string>hash<std::pmr::u8string>
(C++17)(C++17)(C++17)(C++17)(C++20)
 
Определено в заголовочном файле <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 с настроенными аллокаторами не была доступна доступна

[править] Смотрите также

(C++11)
 Объект хеш-функции
(шаблон класса) [править]
(C++17)(C++17)(C++20)(C++17)(C++17)
 поддержка хэширования для строковых представлений
(специализация шаблона класса) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/hash&oldid=63753»