Standard C++ Library Reference ISO/IEC (VERSION3)

basic_stringbuf::overflow
virtual int_type overflow(int_type meta =
traits_type::eof());
If meta does not compare equal to traits_type::eof(), the protected virtual member
function endeavors to insert the element traits_type::to_char_type(meta) into the
output buffer. It can do so in various ways:
If a write position is available, it can store the element into the write position and
increment the next pointer for the output buffer.
●
It can make a write position available by allocating new or additional storage for the
output buffer. (Extending the output buffer this way also extends any associated input
buffer.)
●
If the function cannot succeed, it returns traits_type::eof(). Otherwise, it returns
traits_type::not_eof(meta).
basic_stringbuf::pbackfail
virtual int_type pbackfail(int_type meta =
traits_type::eof());
The protected virtual member function endeavors to put back an element into the input buffer,
then make it the current element (pointed to by the next pointer). If meta compares equal to
traits_type::eof(), the element to push back is effectively the one already in the stream
before the current element. Otherwise, that element is replaced by byte =
traits_type::to_char_type(meta). The function can put back an element in various
ways:
If a putback position is available, and the element stored there compares equal to byte,
it can simply decrement the next pointer for the input buffer.
●
If a putback position is available, and if the stringbuf mode permits the sequence to be
altered (mode & ios_base::out is nonzero), it can store byte into the putback
position and decrement the next pointer for the input buffer.
●
If the function cannot succeed, it returns traits_type::eof(). Otherwise, it returns
traits_type::not_eof(meta).
basic_stringbuf::pos_type
typedef typename traits_type::pos_type pos_type;
The type is a synonym for traits_type::pos_type.