[#bsl-basic_istringstream-2constructor-032590]
= xref:bsl.adoc[bsl]::xref:bsl/basic_istringstream.adoc[basic_istringstream]::basic_istringstream
:relfileprefix: ../../
:mrdocs:

Create a `basic_istringstream` object. Optionally specify a `modeBitMask` indicating whether the underlying stream‐buffer may also be written to (`rdbuf` is created using `modeBitMask | ios_base::in`). If `modeBitMask` is not supplied, `rdbuf` will be created using `ios_base::in`. Optionally specify an `initialString` indicating the sequence of characters from which input will be streamed. If `initialString` is not supplied, there will not be data to stream (until a subsequent call to the `str` manipulator). 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_istringstream.h>`

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


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