SysTutorials

Linux Manual Pages › Section 3

stdfilesystempathfilename(3)

std::filesystem::path::filename - std::filesystem::path::filename

Synopsis

path filename() const; (since C++17) Returns the generic-format filename component of the path. Equivalent to relative_path().empty() ? path() : *–end().

Parameters

(none)

Return value

The filename identified by the path.

Exceptions

(none)

Example

// Run this code

#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’;
}

Possible output:

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

See also

                 returns the file extension path component extension (public member function)                  returns the stem path component stem (public member function)                  replaces the last path component with another path replace_filename (public member function)                  checks if the corresponding path element is not empty has_filename (public member function)