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

Name

Description

__s

Pointer to an array.

__n

Maximum number of characters to store in __s.

__delim

A "stop" character.

Created with MrDocs