Share via


strstreambuf::overflow

A protected virtual function that can be called when a new character is inserted into a full buffer.

virtual int overflow( 
   int _Meta = EOF 
);

Parameters

  • _Meta
    The character to insert into the buffer, or EOF.

Return Value

If the function cannot succeed, it returns EOF. Otherwise, if _Meta == EOF, it returns some value other than EOF. Otherwise, it returns _Meta.

Remarks

If _Meta != EOF, the protected virtual member function tries to insert the element (char)_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.

  • If the stored strstreambuf mode says the controlled sequence is modifiable, extendable, and not frozen, the function can make a write position available by allocating new for the output buffer. Extending the output buffer this way also extends any associated input buffer.

Requirements

Header: <strstream>

Namespace: std

See Also

Reference

strstreambuf Class

iostream Programming

iostreams Conventions