[#bsl-basic_stringbuf-2constructor-04f]
= 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. Use the specified `modeBitMask` to indicate whether this buffer may be read from, written to, or both. 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.

== Synopsis

Declared in `<bslstl_stringbuf.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class SALLOC>
basic_stringbuf(
    xref:bsl/basic_string-0faf.adoc[bsl::basic_string<CHAR_TYPE, CHAR_TRAITS, SALLOC>] const& initialString,
    std::ios_base::openmode modeBitMask,
    xref:bsl/basic_stringbuf/allocator_type.adoc[allocator_type] const& allocator = allocator_type())
requires !bsl::is_same<ALLOCATOR, SALLOC>::value;
----


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