To read a number of characters from an input stream buffer.

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

The characters are read by repeated calls to sbumpc() until either n characters have been assigned or EOF is encountered.

Returns the number of characters read.