std::filesy...ve_filename(3)

🌸 NAME 🌸

std::filesystem::path::remove_filename — and the NAME line is literally std::filesystem::path::remove_filename to std::filesystem::path::remove_filename (repetition ate, no notes 💅). This page is from the C++ Standard Libary manual, and the header shows the very truncated title std::filesy...ve_filename(3) exactly like that. Manual name folded in near the top like a little name tag, bestie. 🎀

---

✨ Synopsis ✨

Here’s the signature, and yes it’s giving main character energy since C++17:

path& remove_filename();  (since C++17)

remove_filename() removes a single generic-format filename component — the thing filename returns — from the given generic-format path.

After this function completes, has_filename returns false. Periodt. 💅

---

🫶 Parameters 🫶

• (none) — no params, no stress, she takes nothing. 😌

---

💖 Return value 💖

*this — that’s it, that’s the return value. 🫶

---

😭 Exceptions 😭

May throw implementation-defined exceptions. (Not me reading “implementation-defined” and side-eyeing the standard 🙈.)

---

🌈 Example 🌈

       // Run this code

        #include <filesystem>
        #include <iostream>
        namespace fs = std::filesystem;

        int main()
        {
            fs::path p;
            std::cout << std::boolalpha
                      << (p = "foo/bar").remove_filename() << '\t' <<
       p.has_filename() << '\n'
                      << (p = "foo/").remove_filename() << '\t' <<
       p.has_filename() << '\n'
                      << (p = "/foo").remove_filename() << '\t' <<
       p.has_filename() << '\n'
                      << (p = "/").remove_filename() << '\t' <<
       p.has_filename() << '\n'
                      << (p = "").remove_filename() << '\t' << p.has_filename()
       << '\n';
        }

💖 Output 💖

"foo/"  false
"foo/"  false
"/"     false
"/"     false
""      false

---

🦋 See also 🦋

• filename — returns the filename 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). ✨

---

made with 💖 from http://cppreference.com, dated 2024.06.10 — source/version + date, bestie, and that’s the whole footer. bye! 👑