std::ostrstream::pcount(3)

✨ NAME ✨

Okay bestie, welcome to the std::ostrstream::pcount(3) page from the C++ Standard Libary manual 🫶. The name is literally std::ostrstream::pcount — std::ostrstream::pcount (yes, it said it twice, and honestly? iconic 💅).

---

🧚 Synopsis 🧚

Here's the signature, no cap:

int pcount() const;  (deprecated in C++98)
                     (removed in C++26)

⚠️ Important vibe check: this is deprecated in C++98 and removed in C++26. So like... it's giving legacy era, bestie 💀.

So what does it actually do? It returns the number of characters that were output in the put area of the associated std::strstreambuf 🌸. Effectively calls rdbuf()->pcount().

---

🙈 Parameters 🙈

None. Literally none. Zero. Nada. No arguments to pass, bestie 🫶.

---

💖 Return value 💖

The number of characters in the put area, or zero if nothing was output. That's it. That's the whole return-value moment ✨.

---

🌈 Example 🌈

// Run this code — like, go off 👇

#include <iostream>
#include <strstream>

int main()
{
    std::ostrstream dyn; // dynamically-allocated output buffer
    dyn << "Test: " << 1.23 << std::ends;
    std::cout << "The size of the output is " << dyn.pcount()
              << " and it holds \"" << dyn.str() << "\"\n";
    dyn.freeze(false);

    char buf[10];
    std::ostrstream user(buf, 10); // user-provided output buffer
    user << 1.23; // note: no std::ends
    std::cout.write(buf, user.pcount());
    std::cout << '\n';
}

---

🖥️ Output 🖥️

The size of the output is 11 and it holds "Test: 1.23"
1.23

---

👀 See also 👀

• pcount — returns the next pointer minus the beginning pointer in the output sequence: pcount is the number of characters written (public member function of std::strstreambuf). 👑

---

And that's the page, bestie 💜. Source/version: http://cppreference.com, dated 2024.06.10 — cute little footer folded into this sign-off instead of copied as a line 🎀. Bye! 🦋