std::strstreambuf::pcount(3)

📦 version 2024.07.05, in nixpkgs unstable, opensuse-leap 16.0

NAME 💖

okay bestie, welcome to std::strstreambuf::pcount from the C++ Standard Libary manual — yes, that's the vibe. This function is literally deprecated in C++98 and removed in C++26, so it's giving legacy icon, but we still gotta know what it does. It returns the number of characters written to the output sequence. 💅

Synopsis 🦋

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

If the next pointer for the put area (std::streambuf::pptr()) is a null pointer, it returns zero. No cap.

Otherwise, it returns the next pointer in the put area minus the beginning pointer in the put area, that is pptr() - pbase(). Math but make it couture. ✨

Parameters 🌸

(none) — that's it, bestie. No params, no drama. 🫶

Return value 💖

The number of characters written to the put area. Periodt. 👑

Example 🎀

#include <iostream>
#include <strstream>

int main()
{
    std::strstream dyn; // dynamically-allocated output buffer
    dyn << "Test: " << 1.23 << std::ends;
    std::strstreambuf* buf = dyn.rdbuf();
    std::cout << "The size of the output is "
              << buf->pcount() // or just buf.pcount()
              << " and it holds \"" << dyn.str() << "\"\n";
    dyn.freeze(false); // after calling .str() on a dynamic strstream

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

    std::istrstream lit("1 2 3"); // read-only fixed-size buffer
    buf = lit.rdbuf();
    // istrstream has no member pcount(), so lit.pcount() won't work
    std::cout << "Input-only pcount() = " << buf->pcount() << '\n';
}

Output: ✨

The size of the output is 11 and it holds "Test: 1.23"
1.23
Input-only pcount() = 0