std::istrstream::rdbuf(3)

🎀 NAME 🎀

std::istrstream::rdbuf — literally std::istrstream::rdbuf, bestie. This page is from the C++ Standard Libary manual, and it's giving “niche member function lore” in the best way. 💅

✨ Synopsis ✨

strstreambuf* rdbuf() const;  (deprecated in C++98)
                               (removed in C++26)

Okay so this one returns a pointer to the associated std::strstreambuf, and it is casting away its constness — yes, even though the member function itself has that const qualifier. The audacity, honestly. 😭

Heads up: this is marked deprecated in C++98 and removed in C++26. So she's iconic, but she's also on her way out. 🫶

🦋 Parameters 🦋

• (none) — no arguments, no extra homework, we love that for us. ✨

🌸 Return value 🌸

A pointer to the associated std::strstreambuf, with constness cast away. That's the whole vibe check: pointer, associated std::strstreambuf, constness gone. 🎀

💖 Example 💖

// Run this code

#include <strstream>

int main()
{
    const std::istrstream buf("example");
    std::strstreambuf* ptr = buf.rdbuf();
}

This is the example, kept exactly as it is — const std::istrstream buf("example");, then std::strstreambuf* ptr = buf.rdbuf();. No cap, that's the whole little main character moment. 🌟

xoxo, from cppreference.com, version/date 2024.06.10, and the page is std::istrstream::rdbuf(3) — slay and goodbye bestie 💜🦋