Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::filesystem::path::filename

Returns the generic-format filename component of the path.

NotebookLM
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

May throw implementation-defined exceptions.

Example

example.cpp
#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"

See also

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

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.