cpp / latest / filesystem / path / parent_path.html /

std::filesystem::path::parent_path

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

Returns the path to the parent directory.

If has_relative_path() returns false, the result is a copy of *this. Otherwise, the result is a path whose generic format pathname is the longest prefix of the generic format pathname of *this that produces one fewer element in its iteration.

Parameters

(none).

Return value

The path to the parent directory.

Exceptions

May throw implementation-defined exceptions.

Example

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

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/parent_path