basic_streambuf::xsgetn

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
);

Parameters

  • _Ptr
    The buffer to contain the extracted characters.

  • _Count
    The number of elements to extract.

Return Value

The number of elements extracted.

Remarks

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.

Requirements

Header: <streambuf>

Namespace: std

See Also

Concepts

basic_streambuf Class

basic_streambuf Members

iostream Programming

iostreams Conventions