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

💖 std::experi...th::filename(3) 💖

okay bestie, welcome to the C++ Standard Libary manual, section 3 — this page is all about std::experi...th::filename, aka std::experimental::filesystem::path::filename. the way this is a whole member function just for the filename component… iconic.

🌸 NAME 🌸

std::experi...th::filename — std::experimental::filesystem::path::filename. that's the name, no cap.

✨ Synopsis ✨

path filename() const;  (filesystem TS)

Returns the filename component of the path.

It’s equivalent to empty() ? path() : *--end() — literally that expression, bestie, don’t @ me.

🎀 Parameters 🎀

There are none. Zero. Nada. The page says (none), and it means it.

🦋 Return value 🦋

The filename identified by the path. that’s it, that’s the return value.

💅 Exceptions 💅

May throw implementation-defined exceptions. so yeah, keep that in mind — implementation-defined is doing a lot of heavy lifting there.

🍓 Example 🍓

// Run this code

#include <experimental/filesystem>
#include <iostream>
namespace fs = std::experimental::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';
}

🔥 Output 🔥

"bar.txt"
".bar"
"."
"."
".."
"."
".."
"/"

👑 See also 👑

• extension — returns the file extension path component (public member function)
• stem — returns the stem path component (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)

🌈 Category 🌈

• Noindexed pages

xoxo, your local Unix bestie 💅 — source: http://cppreference.com; version/date: 2024.06.10. fr fr, that’s the whole page.