Describes an object that controls insertion and extraction of elements and encoded objects using a stream buffer of class basic_stringbuf< Elem, Tr, Alloc>.

template <class Elem, class Tr = char_traits<Elem>, class Alloc = allocator<Elem>>
class basic_stringstream : public basic_iostream<Elem, Tr>

Alloc The allocator class.

Elem The type of the basic element of the string.

Tr The character traits specialized on the basic element of the string.

The template class describes an object that controls insertion and extraction of elements and encoded objects using a stream buffer of class basic_stringbuf< Elem, Tr, Alloc>, with elements of type Elem, whose character traits are determined by the class Tr, and whose elements are allocated by an allocator of class Alloc. The object stores an object of class basic_stringbuf< Elem, Tr, Alloc>.

Header: <sstream>

Namespace: std

The type is a synonym for the template parameter Alloc.

typedef Alloc allocator_type;

Constructs an object of type basic_stringstream.

explicit basic_stringstream(ios_base::openmode _Mode = ios_base::in | ios_base::out);

explicit basic_stringstream(const basic_string<Elem, Tr, Alloc>& str, ios_base::openmode _Mode = ios_base::in | ios_base::out);

_Mode One of the enumerations in ios_base::openmode.

str An object of type basic_string.

The first constructor initializes the base class by calling basic_iostream( sb), where sb is the stored object of class basic_stringbuf< Elem, Tr, Alloc>. It also initializes sb by calling basic_stringbuf< Elem, Tr, Alloc>( _Mode).

The second constructor initializes the base class by calling basic_iostream( sb). It also initializes sb by calling basic_stringbuf< Elem, Tr, Alloc>(_ Str, _Mode).

Returns the address of the stored stream buffer of type pointer to basic_stringbuf< Elem, Tr, Alloc>.

basic_stringbuf<Elem, Tr, Alloc> *rdbuf() const;

The address of the stored stream buffer of type pointer to basic_stringbuf< Elem, Tr, Alloc>.

See basic_filebuf::close for an example that uses rdbuf.

Sets or gets the text in a string buffer without changing the write position.

basic_string<Elem, Tr, Alloc> str() const;


void str(
    const basic_string<Elem, Tr, Alloc>& _Newstr);

_Newstr The new string.

Returns an object of class basic_string< Elem, Tr, Alloc>, whose controlled sequence is a copy of the sequence controlled by *this.

The first member function returns rdbuf -> str. The second member function calls rdbuf -> str( _Newstr).

See basic_stringbuf::str for an example that uses str.

Thread Safety in the C++ Standard Library
iostream Programming
iostreams Conventions