bsl::basic_istringstream::putback

Unextracting a single character.

Synopsis

Declared in <bslstl_istringstream.h>

__istream_type&
putback(char_type __c);

Description

If rdbuf() is not null, calls rdbuf()->sputbackc(c).

If rdbuf() is null or if sputbackc() fails, sets badbit in the error state.

NOTE

This function first clears eofbit. Since no characters are extracted, the next call to gcount() will return 0, as required by DR 60.

Return Value

*this

Parameters

NameDescription
__cThe character to push back into the input stream.