Consumes data from the buffer; writes to the controlled sequence.
Declared in <bslstl_syncbuf.h>
virtual
int_type
overflow(int_type __c = traits_type::eof());Informally, this function is called when the output buffer is full (or does not exist, as buffering need not actually be done). If a buffer exists, it is consumed, with some effect on the controlled sequence. (Typically, the buffer is written out to the sequence verbatim.) In either case, the character c is also written out, if __c is not eof().
For a formal definition of this function, see a good text such as Langer & Kreft, or [27.5.2.4.5]/3-7.
A functioning output streambuf can be created by overriding only this function (no buffer area will be used).
Base class version does nothing, returns eof().
eof() to indicate failure, something else (usually __c, or not_eof())
| Name | Description |
|---|---|
| __c | An additional character to consume. |