bsl::basic_istringstream::get

Simple multiple-character extraction.

Synopsis

Declared in <bslstl_istringstream.h>

__istream_type&
get(
    char_type* __s,
    streamsize __n,
    char_type __delim);

Description

Characters are extracted and stored into __s until one of the following happens:

  • __n-1 characters are stored

  • the input sequence reaches EOF

  • the next character equals __delim, in which case the character is not extracted

If no characters are stored, failbit is set in the stream's error state.

In any case, a null character is stored into the next location in the array.

NOTE

This function is not overloaded on signed char and unsigned char.

Return Value

*this

Parameters

NameDescription
__sPointer to an array.
__nMaximum number of characters to store in __s.
__delimA "stop" character.