std::filesy...th::filename(3)

🎀 std::filesystem::path::filename 🎀

okay bestie, welcome to the std::filesy...th::filename(3) page from the C++ Standard Libary manual — yep, manual name folded in right here, no boring header line for us 💅✨

💖 NAME 💖

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

like, that's the name and also the name again. iconic. 🫶

🦋 Synopsis 🦋

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

It returns the generic-format filename component of the path. no cap.

It's equivalent to relative_path().empty() ? path() : *--end() — literally that.

🌸 Parameters 🌸

(none) — zero, zilch, nada, no parameters bestie. 🍓

✨ Return value ✨

The filename identified by the path. that's it, that's the tea. periodt.

🔥 Exceptions 🔥

⚠️ May throw implementation-defined exceptions. so like, keep that in mind, mwah.

🧚 Example 🧚

// Run this code

#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 🌈

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

byeee bestie 🫶💋 — source is http://cppreference.com, version/date is 2024.06.10, and this cutie page is std::filesy...th::filename(3). mwah, slay, periodt ✨