[#bsl-basic_stringbuf-2constructor-0b]
= xref:bsl.adoc[bsl]::xref:bsl/basic_stringbuf.adoc[basic_stringbuf]::basic_stringbuf
:relfileprefix: ../../
:mrdocs:

Create a `basic_stringbuf` object. Use the specified `initialString` indicating the initial sequence of characters that this buffer will access or manipulate. Optionally specify a `modeBitMask` indicating whether this buffer may be read from, written to, or both. If `modeBitMask` is not supplied, this buffer is created with `ios_base::in | ios_base::out`. Optionally specify the `allocator` used to supply memory. If `allocator` is not supplied, the allocator in `initialString` is used. `initialString` is left in a valid but unspecified state.

== Synopsis

Declared in `<bslstl_stringbuf.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
basic_stringbuf(xref:BloombergLP/bslmf/MovableRef.adoc[BloombergLP::bslmf::MovableRef<StringType>] initialString);
----


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