Namespaces
Variants

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

From cppreference.net
C++
Filesystem library
Classes
Functions
File types
Определено в заголовочном файле <filesystem>
path relative ( const std:: filesystem :: path & p,
std:: error_code & ec ) ;
(1) (начиная с C++17)
(2) (начиная с C++17)
path relative ( const std:: filesystem :: path & p,

const std:: filesystem :: path & base,

std:: error_code & ec ) ;
(3) (начиная с C++17)
path proximate ( const std:: filesystem :: path & p,
std:: error_code & ec ) ;
(4) (начиная с C++17)
(5) (начиная с C++17)
path proximate ( const std:: filesystem :: path & p,

const std:: filesystem :: path & base,

std:: error_code & ec ) ;
(6) (начиная с C++17)
1) Возвращает relative ( p, current_path ( ) , ec ) .
2,3) Возвращает p относительно base . Разрешает символические ссылки и нормализует как p , так и base перед дальнейшей обработкой. Фактически возвращает std:: filesystem :: weakly_canonical ( p ) . lexically_relative ( std:: filesystem :: weakly_canonical ( base ) ) или std:: filesystem :: weakly_canonical ( p, ec ) . lexically_relative ( std:: filesystem :: weakly_canonical ( base, ec ) ) , за исключением того, что форма с кодом ошибки возвращает path ( ) при первом возникновении ошибки, если таковая имеется.
4) Возвращает proximate ( p, current_path ( ) , ec ) .
5,6) Фактически возвращает std:: filesystem :: weakly_canonical ( p ) . lexically_proximate ( std:: filesystem :: weakly_canonical ( base ) ) или std:: filesystem :: weakly_canonical ( p, ec ) . lexically_proximate ( std:: filesystem :: weakly_canonical ( base, ec ) ) , за исключением того, что форма с кодом ошибки возвращает path ( ) при первом возникновении ошибки, если таковая имеется.

Содержание

Параметры

p - существующий путь
base - базовый путь, относительно которого p будет сделан относительным/приближенным
ec - код ошибки для сохранения статуса ошибки

Возвращаемое значение

1) p приведен к относительному пути относительно current_path ( ) .
2,3) p приведён к относительному пути относительно base .
4) p приведен к относительному пути относительно current_path ( ) .
5,6) p приближено к base .

Исключения

Любая перегрузка, не помеченная noexcept , может выбрасывать std::bad_alloc при неудачном выделении памяти.

2,5) Выбрасывает std::filesystem::filesystem_error при ошибках базового API ОС, создавая исключение с p в качестве первого аргумента пути, base в качестве второго аргумента пути и кодом ошибки ОС в качестве аргумента кода ошибки.
1,3,4,6) Устанавливает параметр std:: error_code & в код ошибки API ОС при сбое вызова API ОС, и выполняет ec. clear ( ) если ошибок не возникает.

Пример

Запустить этот код 
#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");
}

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

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"

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

(C++17)
представляет путь
(класс)
(C++17)
формирует абсолютный путь
(функция)
(C++17)
формирует канонический путь
(функция)
преобразует путь в нормальную форму
преобразует путь в относительную форму
преобразует путь в приближенную форму
(публичная функция-член std::filesystem::path )