[#BloombergLP-bslx-OutStreamFunctions-bdexStreamOut-004]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslx.adoc[bslx]::xref:BloombergLP/bslx/OutStreamFunctions.adoc[OutStreamFunctions]::bdexStreamOut
:relfileprefix: ../../../
:mrdocs:

BDEX&hyphen;stream a `bsl&colon;&colon;string` `value` to `stream`&period;

== Synopsis

Declared in `&lt;bslx&lowbar;outstreamfunctions&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class STREAM&gt;
STREAM&
bdexStreamOut(
    STREAM& stream,
    xref:bsl/string.adoc[bsl::string] const& value,
    int version = 0);
----

== Description

Write the specified `bsl&colon;&colon;string` `value` to the specified output `stream`, and return a reference to `stream`&period; The optionally specified `version` is ignored&period; If `stream` is initially invalid, this operation has no effect&period; See the `bslx` package&hyphen;level documentation for more information on BDEX streaming of value&hyphen;semantic types and containers&period;

== Return Value

a reference to `stream`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *stream*
| output stream to write to
| *value*
| string value to externalize
| *version*
| ignored version number
|===


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