◐ Shell
clean mode source ↗

std::filesystem::hash_value - cppreference.com

De cppreference.com

Definido en el archivo de encabezado <filesystem>

std::size_t hash_value( const std::filesystem::path& p ) noexcept;

 (desde C++17)

Parámetros

p - Un objeto std::filesystem::path.

Valor de retorno

Un valor de dispersión o valor resumen tal que si para dos rutas de acceso p1 == p2, entonces hash_value(p1) == hash_value(p2).

Notas

La igualdad de dos rutas de acceso se determina comparando cada componente de manera separada, así que, por ejemplo, "a//b" es igual a "a/b" y tiene el mismo valor de dispersión.

hash_value se origina de la biblioteca Boost.Filesystem, donde se usó para la interoperabilidad con boost.hash (que llama a hash_value encontrado por la búsqueda dependiente de argumentos o boost::hash_value cuando está disponible).

Ejemplo

#include <cassert>
#include <cstddef>
#include <iomanip>
#include <iostream>
#include <filesystem>
#include <unordered_set>
namespace fs = std::filesystem;

void mostrar_valor_de_dispersion(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) );
    mostrar_valor_de_dispersion( tmp1 );
    mostrar_valor_de_dispersion( tmp2 );

    for (auto s : {"/a///b", "/a//b", "/a/c", "...", "..", ".", ""})
        mostrar_valor_de_dispersion(s);

    // Un objeto función de dispersión/función resumen para que funcione con
    // punteros a  contenedores no ordenados (unordered_*):
    struct HashDeRuta {
        std::size_t operator()(fs::path const& p) const noexcept {
            return fs::hash_value(p);
        }
    };
    std::unordered_set<fs::path, HashDeRuta> dirs {
        "/bin", "/bin", "/lib", "/lib", "/opt", "/opt", "/tmp", "/tmp/../tmp"
    };
    for (fs::path const& p: dirs) { std::cout << p << ' '; }
}

Posible salida: 

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

Véase también