std::emit_on_flush, std::no_emit_on_flush

< cpp‎ | io‎ | manip
 
 
Input/output library
I/O manipulators
C-style I/O
Buffers
(deprecated in C++98)
Streams
Abstractions
File I/O
String I/O
Array I/O
(deprecated in C++98)
(deprecated in C++98)
(deprecated in C++98)
Synchronized Output
Types
Error category interface
(C++11)
 
Input/output manipulators
Floating-point formatting
Integer formatting
Boolean formatting
Field width and fill control
Other formatting
Whitespace processing
Output flushing
emit_on_flushno_emit_on_flush
(C++20)(C++20)
Status flags manipulation
Time and money I/O
(C++11)
(C++11)
(C++11)
(C++11)
Quoted manipulator
(C++14)
 
Defined in header <ostream>
template< class CharT, class Traits >
std::basic_ostream<CharT, Traits>& emit_on_flush( std::basic_ostream<CharT, Traits>& os );
(1) (since C++20)
template< class CharT, class Traits >
std::basic_ostream<CharT, Traits>& no_emit_on_flush( std::basic_ostream<CharT, Traits>& os );
(2) (since C++20)

If os.rdbuf() actually points to a std::basic_syncbuf<CharT, Traits, Allocator> buf, toggles whether it emits (i.e., transmits data to the underlying stream buffer) when flushed:

1) calls buf.set_emit_on_sync(true)
2) calls buf.set_emit_on_sync(false)

Otherwise, these manipulators have no effect.

This is an output-only I/O manipulator, it may be called with an expression such as out << std::emit_on_flush for any out of type std::basic_ostream.


Parameters

os - reference to output stream

Return value

os (reference to the stream after manipulation)

Example

See also

changes the current emit-on-sync policy
(public member function of std::basic_syncbuf<CharT,Traits,Allocator>)