To show a failure in a put back operation.

virtual int_type pbackfail (int_type c = traits::eof());

The resulting conditions are the same as the function underflow().

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.