< cpp‎ | experimental‎ | fs‎ | path
Technical specifications
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
path relative_path() const;
(filesystem TS)

Returns path relative to root path. If *this is an empty path, returns an empty path.


[edit] Parameters


[edit] Return value

Path relative to the root path.

[edit] Exceptions

May throw implementation-defined exceptions.

[edit] Example

#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::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"

[edit] See also

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