Namespaces
Variants

    std::filesystem:: relative, std::filesystem:: proximate

    From es.cppreference.net
    C++
    Filesystem library
    Classes
    Functions
    File types
    Definido en el encabezado <filesystem>
    path relative ( const std:: filesystem :: path & p,
    std:: error_code & ec ) ;
    		(1) (desde C++17)
    (2) (desde C++17)
    path relative ( const std:: filesystem :: path & p,

    const std:: filesystem :: path & base,

    std:: error_code & ec ) ;
    		(3) (desde C++17)
    path proximate ( const std:: filesystem :: path & p,
    std:: error_code & ec ) ;
    		(4) (desde C++17)
    (5) (desde C++17)
    path proximate ( const std:: filesystem :: path & p,

    const std:: filesystem :: path & base,

    std:: error_code & ec ) ;
    		(6) (desde C++17)
    1) Devuelve relative ( p, current_path ( ) , ec ) .
    2,3) Devuelve p convertido en relativo a base . Resuelve enlaces simbólicos y normaliza tanto p como base antes de cualquier otro procesamiento. Efectivamente devuelve std:: filesystem :: weakly_canonical ( p ) . lexically_relative ( std:: filesystem :: weakly_canonical ( base ) ) o std:: filesystem :: weakly_canonical ( p, ec ) . lexically_relative ( std:: filesystem :: weakly_canonical ( base, ec ) ) , excepto que la forma con código de error devuelve path ( ) en la primera ocurrencia de error, si la hay.
    4) Devuelve proximate ( p, current_path ( ) , ec ) .
    5,6) Efectivamente retorna std:: filesystem :: weakly_canonical ( p ) . lexically_proximate ( std:: filesystem :: weakly_canonical ( base ) ) o std:: filesystem :: weakly_canonical ( p, ec ) . lexically_proximate ( std:: filesystem :: weakly_canonical ( base, ec ) ) , excepto que la forma con código de error retorna path ( ) en la primera ocurrencia de error, si la hay.

    Contenidos

    Parámetros

    p - una ruta existente
    base - ruta base, contra la cual p será hecho relativo/proximal
    ec - código de error para almacenar el estado de error

    Valor de retorno

    1) p hecho relativo contra current_path ( ) .
    2,3) p hecho relativo respecto a base .
    4) p hecho próximo contra current_path ( ) .
    5,6) p hecho próximo contra base .

    Excepciones

    Cualquier sobrecarga no marcada como noexcept puede lanzar std::bad_alloc si la asignación de memoria falla.

    2,5) Lanza std::filesystem::filesystem_error en errores de la API del sistema operativo subyacente, construido con p como primer argumento de ruta, base como segundo argumento de ruta, y el código de error del sistema operativo como argumento de código de error.
    1,3,4,6) Establece un parámetro std:: error_code & al código de error de la API del sistema operativo si una llamada a la API del SO falla, y ejecuta ec. clear ( ) si no ocurren errores.

    Ejemplo

    Ejecutar este código 
    #include <filesystem>
#include <iostream>
void show(std::filesystem::path x, std::filesystem::path y)
{
    std::cout << "x:\t\t " << x << "\ny:\t\t " << y << '\n'
              << "relative(x, y):  "
              << std::filesystem::relative(x, y) << '\n'
              << "proximate(x, y): "
              << std::filesystem::proximate(x, y) << "\n\n";
}
int main()
{
    show("/a/b/c", "/a/b");
    show("/a/c", "/a/b");
    show("c", "/a/b");
    show("/a/b", "c");
}

    Salida posible: 

    x:               "/a/b/c"
y:               "/a/b"
relative(x, y):  "c"
proximate(x, y): "c"
x:               "/a/c"
y:               "/a/b"
relative(x, y):  "../c"
proximate(x, y): "../c"
x:               "c"
y:               "/a/b"
relative(x, y):  ""
proximate(x, y): "c"
x:               "/a/b"
y:               "c"
relative(x, y):  ""
proximate(x, y): "/a/b"

    Véase también

    (C++17)
    		representa una ruta
    (clase)
    (C++17)
    		compone una ruta absoluta
    (función)
    (C++17)
    		compone una ruta canónica
    (función)
    		convierte la ruta a forma normal
    convierte la ruta a forma relativa
    convierte la ruta a forma próxima
    (función miembro pública de std::filesystem::path )