[#bsl-basic_stringbuf-str-0c4]
= xref:bsl.adoc[bsl]::xref:bsl/basic_stringbuf.adoc[basic&lowbar;stringbuf]::str
:relfileprefix: ../../
:mrdocs:

Reset the buffered character sequence to the specified `value`&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
str(xref:bsl/basic_stringbuf.adoc[StringType] const& value);
----

== Description

Reset the internally buffered sequence of characters to the specified `value`&period; Update the beginning and end of both the input and output sequences to be the beginning and end of the updated buffer, update the current input position to be the beginning of the updated buffer, and update the current output position to be the end of the updated buffer&period; If `value` is passed by `MovableRef`, then it is left in an unspecified but valid state&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *value*
| new character sequence for the buffer
|===


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