Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer


Protected, virtual function to extract elements from the input stream.

This method is potentially unsafe, as it relies on the caller to check that the passed values are correct. Consider using basic_streambuf::_Xsgetn_s instead.

virtual streamsize xsgetn(
   char_type *_Ptr,
   streamsize _Count


The buffer to contain the extracted characters.


The number of elements to extract.

The number of elements extracted.

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

Header: <streambuf>

Namespace: std

© 2016 Microsoft