basic_streambuf::xsgetn

virtual streamsize xsgetn(E *s, streamsize n);

The protected virtual member function extracts up to n elements from the input stream, as if by repeated calls to sbumpc, and stores them in the array beginning at s. It returns the number of elements actually extracted.