[#bsl-noemit_on_flush]
= xref:bsl.adoc[bsl]::noemit&lowbar;on&lowbar;flush
:relfileprefix: ../
:mrdocs:

Disable emit&hyphen;on&hyphen;flush for a `basic&lowbar;syncbuf` backing `stream`&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class CHAR,
    class TRAITS&gt;
basic&lowbar;ostream&lt;CHAR, TRAITS&gt;&
noemit&lowbar;on&lowbar;flush(basic&lowbar;ostream&lt;CHAR, TRAITS&gt;& stream);
----

== Description

If, for the specified `stream`, `stream&period;rdbuf()` is a `basic&lowbar;syncbuf&lt;CHAR,TRAITS,ALLOCATOR&gt;`, make `stream` not emit (i&period;e&period;, don&apos;t transmit data to the wrapped stream buffer) when flushed, otherwise has no effect&period; Return `stream`&period;

== Return Value

a reference to `stream`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *stream*
| output stream that may wrap a `basic&lowbar;syncbuf`
|===


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