bsl::basic_stringbuf::overflow

Append a character to the output sequence.

Synopsis

Declared in <bslstl_stringbuf.h>

virtual
basic_stringbuf<CHAR_TYPE, CHAR_TRAITS, ALLOCATOR>::int_type
overflow(int_type character = traits_type::eof());

Description

Append the specified character to the output sequence of this stream buffer at the current output position (pptr), and advance the output position by one. This operation may update the end of output area (epptr) to allow for additional writes (e.g., by the base basic_streambuf type) to the output sequence without calling a method on this type. Return the written character on success, and traits_type::eof() if character is traits_type::eof() or this stream buffer was not opened for writing.