std::experi...::path::stem(3)

💅 std::experimental::filesystem::path::stem 💅

okay bestie, welcome to the C++ Standard Libary corner for std::experimental::filesystem::path::stem from the filesystem TS. it’s giving “give me the filename but make it de-extensioned,” and honestly? iconic. ✨

---

🌸 NAME 🌸

• std::experimental::filesystem::path::stem — std::experimental::filesystem::path::stem

yes, the name is literally printed twice in the original. we love a dramatic entrance. 💅

---

🦋 Synopsis 🦋

path stem() const;  (filesystem TS)

Returns the filename identified by the path stripped of its extension.

The way this works: it returns the substring from the beginning of filename() up to and not including the last period (.) character.

If the filename is one of the special filesystem components dot or dot-dot, or if it has no periods, the function returns the entire filename().

---

🎀 Parameters 🎀

(none) — literally no parameters, bestie. no args, no stress. 🫶

---

⭐ Return value ⭐

The stem of the filename identified by the path.

That’s the whole return value. no cap. 💖

---

🔥 Exceptions 🔥

May throw implementation-defined exceptions.

So like, it might throw, and the exact exception situation is implementation-defined — check with your implementation bestie, not me. 😭

---

🌈 Example 🌈

The original says // Run this code, so here is the code, verbatim:

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

int main()
{
    std::cout << fs::path("/foo/bar.txt").stem() << '\n'
              << fs::path("/foo/.bar").stem() << '\n';

    for (fs::path p = "foo.bar.baz.tar"; !p.extension().empty(); p = p.stem())
        std::cout << p.extension() << '\n';
}

---

🍓 Output 🍓

"bar"
""
".tar"
".baz"
".bar"

---

💜 See also 💜

• filename — returns the filename path component (public member function)
• extension — returns the file extension path component (public member function)

---

🫶 Category 🫶

• Noindexed pages (original line: * Noindexed pages)

---

💖 source: http://cppreference.com · version/date: 2024.06.10 · page: std::experi...::path::stem(3) 💖