< 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 parent_path() const;
(filesystem TS)

Returns the path to the parent directory. Returns empty path if empty() or there's only a single element in the path (begin() == --end()).

The resulting path is constructed by appending all elements in a range [begin()--end()) to an empty path.


[edit] Parameters


[edit] Return value

The path to the parent directory.

[edit] Exceptions

May throw implementation-defined exceptions.

[edit] Example

#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
    for (fs::path p : {"/var/tmp/example.txt", "/", "/var/tmp/."})
        std::cout << "The parent path of " << p
                  << " is " << p.parent_path() << '\n';

Possible output:

The parent path of "/var/tmp/example.txt" is "/var/tmp"
The parent path of "/" is ""
The parent path of "/var/tmp/." is "/var/tmp"

[edit] See also