[#bsl-basic_stringstream-2constructor-08]
= xref:bsl.adoc[bsl]::xref:bsl/basic_stringstream.adoc[basic_stringstream]::basic_stringstream
:relfileprefix: ../../
:mrdocs:

Create a `basic_stringstream` object. Optionally specify a `modeBitMask` indicating whether the underlying stream‐buffer may be read from, written to, or both (`rdbuf` is created using `modeBitMask`). If `modeBitMask` is not supplied, `rdbuf` will be created using `ios_base::in | ios_base::out`. Optionally specify an `initialString` indicating the initial sequence of characters that this stream may access or manipulate. If `initialString` is not supplied, the initial sequence of characters will be empty. Optionally specify the `allocator` used to supply memory. If `allocator` is not supplied, a default‐constructed object of the (template parameter) `ALLOCATOR` type is used. If the `ALLOCATOR` argument is of type `bsl::allocator` (the default), then `allocator`, if supplied, shall be convertible to `bslma::Allocator *`. If the `ALLOCATOR` argument is of type `bsl::allocator` and `allocator` is not supplied, the currently installed default allocator will be used to supply memory. If `initialString` is passed by `MovableRef`, it is left in a valid but unspecified state.

== Synopsis

Declared in `<bslstl_stringstream.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
basic_stringstream(xref:bsl/basic_stringstream/allocator_type.adoc[allocator_type] const& allocator = allocator_type());
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#