Namespaces
Variants
Views
Actions

std::filesystem::path::filename

From cppreference.com
< cpp‎ | filesystem‎ | path
 
 
 
 
path filename() const;
(since C++17)

Returns the generic-format filename component of the path.

Equivalent to relative_path().empty() ? path() : *--end().

Contents

[edit] Parameters

(none)

[edit] Return value

The filename identified by the path.

[edit] Exceptions

May throw implementation-defined exceptions.

[edit] Example

#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;
 
int main()
{
    std::cout << fs::path("/foo/bar.txt").filename() << '\n'
              << fs::path("/foo/.bar").filename() << '\n'
              << fs::path("/foo/bar/").filename() << '\n'
              << fs::path("/foo/.").filename() << '\n'
              << fs::path("/foo/..").filename() << '\n'
              << fs::path(".").filename() << '\n'
              << fs::path("..").filename() << '\n'
              << fs::path("/").filename() << '\n'
              << fs::path("//host").filename() << '\n';
}

Output:

"bar.txt"
".bar"
""
"."
".."
"."
".."
""
"host"

[edit] See also

returns the file extension path component
(public member function) [edit]
returns the stem path component (filename without the final extension)
(public member function) [edit]
replaces the last path component with another path
(public member function) [edit]
checks if the corresponding path element is not empty
(public member function)