bsl::basic_stringbuf::xsgetn

Multiple character extraction.

Synopsis

Declared in <bslstl_stringbuf.h>

virtual
streamsize
xsgetn(
    char_type* __s,
    streamsize __n);

Description

Fills __s[0] through __s[] with characters from the input sequence, as if by sbumpc(). Stops when either __n characters have been copied, or when traits::eof() would be copied.

It is expected that derived classes provide a more efficient implementation by overriding this definition.

Return Value

The number of characters assigned.

Parameters

NameDescription
__sA buffer area.
__nMaximum number of characters to assign.