std::filesystem::hash_value

Defined in header `<filesystem>`
std::size_t hash_value( const std::filesystem::path& p ) noexcept;		(since C++17)

Параметры

p - объект std::filesystem::path

Значение возврата

Значение хэша, такое, что если для двух путей p1 == p2, то hash_value(p1) == hash_value(p2).

Значение возврата согласуется с std::hash.

Примечания

Равенство двух путей определяется путем сравнения каждого компонента по отдельности, поэтому, например "a//b" равно "a/b" и имеет то же hash_value.

hash_value происходит из библиотеки Boost.filesystem, где она использовалась для взаимодействия с boost.hash (который вызывает hash_value найденный с помощью поиска зависимых от аргументов или boost::hash_value, где доступно).

Пример

#include <cassert>
#include <cstddef>
#include <filesystem>
#include <iomanip>
#include <iostream>
#include <unordered_set>
namespace fs = std::filesystem;
 
void show_hash(fs::path const& p)
{
    std::cout << std::hex << std::uppercase << std::setw(16)
              << fs::hash_value(p) << " : " << p << '\n';
}
 
int main()
{
    auto tmp1 = fs::path{"/tmp"};
    auto tmp2 = fs::path{"/tmp/../tmp"};
    assert(!(tmp1 == tmp2));
    assert(fs::equivalent(tmp1, tmp2));
    show_hash(tmp1);
    show_hash(tmp2);
 
    for (auto s : {"/a///b", "/a//b", "/a/c", "...", "..", ".", ""})
        show_hash(s);
 
    // A hash function object to work with unordered_* containers:
    struct PathHash
    {
        std::size_t operator()(fs::path const& p) const noexcept
        {
            return fs::hash_value(p);
        }
    };
    std::unordered_set<fs::path, PathHash> dirs{
        "/bin", "/bin", "/lib", "/lib", "/opt", "/opt", "/tmp", "/tmp/../tmp"};
    for (fs::path const& p : dirs)
        std::cout << p << ' ';
    std::cout << '\n';
}

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

6050C47ADB62DFE5 : "/tmp"
62795A58B69AD90A : "/tmp/../tmp"
FF302110C9991974 : "/a///b"
FF302110C9991974 : "/a//b"
FD6167277915D464 : "/a/c"
C42040F82CD8B542 : "..."
D2D30154E0B78BBC : ".."
D18C722215ED0530 : "."
               0 : ""
"/tmp/../tmp" "/opt" "/lib" "/tmp" "/bin"

См. также

compare	сравнивает лексические представления двух путей лексикографически (публичный член-функция)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++17)(C++17)(до C++20)(C++17)(до C++20)(C++17)(до C++20)(C++17)(до C++20)(C++17)(до C++20)(C++20)	лексикографически сравнивает два пути (функция)
equivalent (C++17)	проверяет, ссылаются ли два пути на один и тот же объект файловой системы (функция)
hash (C++11)	объект-функция хэширования (шаблон класса)
std::hash<std::filesystem::path> (C++17)	поддержка хэширования для `std::filesystem::path` (специализация шаблона класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/path/hash_value