W3cubDocs

/C++

std::filesystem::path::relative_path

path relative_path() const;
(since C++17)

Returns path relative to root-path, that is, a pathname composed of every generic-format component of *this after root-path. If *this is an empty path, returns an empty path.

Parameters

(none).

Return value

Path relative to the root path.

Exceptions

May throw implementation-defined exceptions.

Examples

#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
 
int main()
{
    fs::path p = fs::current_path();
 
    std::cout << "The current path " << p << " decomposes into:\n"
              << "root-path " << p.root_path() << '\n'
              << "relative path " << p.relative_path() << '\n';
}

Possible output:

The current path "C:\Users\abcdef\Local Settings\temp" decomposes into:
root-path "C:\"
relative path "Users\abcdef\Local Settings\temp"

See also

returns the root-name of the path, if present
(public member function)
returns the root directory of the path, if present
(public member function)
returns the root path of the path, if present
(public member function)

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