SysTutorials

Linux Manual Pages › Section 3

stdostrstreampcount(3)

std::ostrstream::pcount - std::ostrstream::pcount

Synopsis

int pcount() const;

Returns the number of characters that were output in the put area of the associated std::strstreambuf. Effectively calls rdbuf()->pcount()

Parameters

(none)

Return value

The number of characters in the put area, or zero if nothing was output.

Example

// Run this code

#include <strstream>
#include <iostream>
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 &quot;" << dyn.str() << "&quot;\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

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