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.

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

Reference

basic_streambuf Class

iostream Programming

iostreams Conventions

Other Resources

basic_streambuf Members