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 <iostream>
#include <filesystem>
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)