[#BloombergLP-bslfmt-streamed-07]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslfmt.adoc[bslfmt]::streamed
:relfileprefix: ../../
:mrdocs:

`streamed` overloads

== Synopses

Declared in `<bslfmt_streamed.h>`

Create and return a `Streamed` wrapper for the specified `object` when `t_STREAMABLE2` is not formattable.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bslfmt/Streamed-0f9.adoc[Streamed<t_STREAMABLE2>]
xref:BloombergLP/bslfmt/streamed-0f3.adoc[streamed](t_STREAMABLE2 const& object)
requires (!bsl::formattable<t_STREAMABLE2, char>);
----

[.small]#xref:BloombergLP/bslfmt/streamed-0f3.adoc[_» more..._]#

Create and return a `Streamed` wrapper for the specified `object` when `t_STREAMABLE2` is already formattable (emits a deprecation warning).


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bslfmt/Streamed-0f9.adoc[Streamed<t_STREAMABLE2>]
xref:BloombergLP/bslfmt/streamed-05.adoc[streamed](t_STREAMABLE2 const& object)
requires (bsl::formattable<t_STREAMABLE2, char>);
----

[.small]#xref:BloombergLP/bslfmt/streamed-05.adoc[_» more..._]#

Create and return a `bslfmt::Streamed` (wrapper) object for the specified streamable `object`. The behavior is undefined unless `t_STREAMABLE` has a standard and well‐behaved `std::ostream` output operator. This wrapper‐creator free function to support compilation with no CTAD (Class Template Argument Deduction); see (#Usage). Notice that for compilations that support the `bsl::formattable` trait we define two concept‐driven overloads of this function, one of which will warn the user (compiler warning) if a `bsl::formatter` already exists for the type they try to streamed‐wrap.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class t_STREAMABLE>
xref:BloombergLP/bslfmt/Streamed-0f9.adoc[bslfmt::Streamed<t_STREAMABLE>]
xref:BloombergLP/bslfmt/streamed-09.adoc[streamed](t_STREAMABLE const& object)
requires (bsl::formattable<t_STREAMABLE, char>);
----

[.small]#xref:BloombergLP/bslfmt/streamed-09.adoc[_» more..._]#

== Parameters

[cols="1,4"]
|===
| Name| Description
| *object*
| Streamable object to wrap for formatting via `operator<<`.
|===


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