Extracting into another streambuf.

Synopsis

Declared in <bslstl_istringstream.h>

__istream_type&
operator>>(__streambuf_type* __sb);

Description

This function behaves like one of the basic arithmetic extractors, in that it also constructs a sentry object and has the same error handling behavior.

If __sb is NULL, the stream will set failbit in its error state.

Characters are extracted from this stream and inserted into the __sb streambuf until one of the following occurs:

  • the input stream reaches end‐of‐file,

  • insertion into the output buffer fails (in this case, the character that would have been inserted is not extracted), or

  • an exception occurs (and in this case is caught)

If the function inserts no characters, failbit is set.

Parameters

Name

Description

__sb

A pointer to a streambuf

Created with MrDocs