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

Create a `basic_stringbuf` object. Use the specified `initialString` (of a type convertible to `basic_string_view<CHAR_TYPE, CHAR_TRAITS>` but not to `const CHAR_TYPE *`) 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 `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 STRING_VIEW_LIKE_TYPE>
basic_stringbuf(
    STRING_VIEW_LIKE_TYPE const& initialString,
    std::ios_base::openmode modeBitMask);
----


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