[#bsl-basic_istringstream-2constructor-032590]
= xref:bsl.adoc[bsl]::xref:bsl/basic_istringstream.adoc[basic&lowbar;istringstream]::basic&lowbar;istringstream
:relfileprefix: ../../
:mrdocs:

Create a `basic&lowbar;istringstream` object&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;istringstream&period;h&gt;`

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

== Description

Optionally specify a `modeBitMask` indicating whether the underlying stream&hyphen;buffer may also be written to (`rdbuf` is created using `modeBitMask &verbar; ios&lowbar;base&colon;&colon;in`)&period; If `modeBitMask` is not supplied, `rdbuf` will be created using `ios&lowbar;base&colon;&colon;in`&period; Optionally specify an `initialString` indicating the sequence of characters from which input will be streamed&period; If `initialString` is not supplied, there will not be data to stream (until a subsequent call to the `str` manipulator)&period; Optionally specify the `allocator` used to supply memory&period; If `allocator` is not supplied, a default&hyphen;constructed object of the (template parameter) `ALLOCATOR` type is used&period; If the `ALLOCATOR` argument is of type `bsl&colon;&colon;allocator` (the default), then `allocator`, if supplied, shall be convertible to `bslma&colon;&colon;Allocator &ast;`&period; If the `ALLOCATOR` argument is of type `bsl&colon;&colon;allocator` and `allocator` is not supplied, the currently installed default allocator will be used to supply memory&period; If `initialString` is passed by `MovableRef`, it is left in a valid but unspecified state&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *allocator*
| allocator used to supply memory
|===


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