To show a failure in a put back operation.
virtual int_type pbackfail
(int_type c = traits::eof());
The function pbackfail overrides the basic_streambuf virtual function.
The function pbackfail() is only called when a put back operation really has failed and returns traits::eof. If success occurs the return is undefined.
basic_streambuf::pbackfail()