|
streambuf::uflowvirtual protected member function
int uflow ( ); Get character in the case of underflow and advance get pointer For the purpose of the streambuf class, underflows happen when a new character is to be read at the get pointer gptr, but this has reached the end pointer egptr, indicating that no more characters are apparently available in the internal input array.This function is expected to modify the eback, gptr and egptr pointers that define the internal input array in such a way that if there are more characters available in the controlled input sequence after the location represented by streambuf::egptr, at least some of them are made available through this internal input array. In this case, the function returns the new character pointed by the get pointer and advances it one position. Otherwise, if there are no more characters available in the controlled input sequence after the one represented by egptr, the function returns EOF (or traits::eof() for other traits). This is a virtual member function that can be overriden for a specific behavior in derived classes. Its default behavior in streambuf is to call its sibling virtual member function underflow and return its value and advance the get pointer in case of success, or return EOF (or traits::eof() for other traits) otherwise. This protected member function is automatically called by sbumpc and snextc member functions when underflows happen. The behavior of this member function is the same as the one of underflow except that this function also advances the get pointer by one position. The derived class filebuf overrides this virtual member function (see filebuf::uflow). ParametersnoneReturn ValueThe new character available at the current get pointer position, if any. Otherwise, EOF (or [=traits::eof() for other traits) is returned.Basic template member declaration( basic_streambuf<charT,traits> )
See also.
|