[#BloombergLP-bslx-GenericOutStream-putString]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslx.adoc[bslx]::xref:BloombergLP/bslx/GenericOutStream.adoc[GenericOutStream]::putString
:relfileprefix: ../../../
:mrdocs:

Write the length and characters of the specified `value` to this stream.

== Synopsis

Declared in `<bslx_genericoutstream.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bslx/GenericOutStream.adoc[GenericOutStream<STREAMBUF>]&
putString(xref:bsl/string.adoc[bsl::string] const& value);
----

== Description

Write to the stream supplied at construction the length of the specified `value` (see `putLength`) and an array of one‐byte, two's complement unsigned integers comprised of the least‐significant one byte of each character in the `value`, and return a reference to this stream. If this stream is initially invalid, this operation has no effect.

== Return Value

a reference to this stream

== Parameters

[cols="1,4"]
|===
| Name| Description
| *value*
| string to write
|===


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