# std::emit_on_flush, std::noemit_on_flush

> C++ Atlas: `cppatlas.com/w/cpp/io/manip/emit_on_flush` | Source: https://en.cppreference.com/w/cpp/io/manip/emit_on_flush | Domain: Input/output | Standards: 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:

## Official Specification Summary (cppreference)

```cpp
// 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>& noemit_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

> Note: This section is incomplete Reason: no example

### See also

- [`set_emit_on_sync`](https://en.cppreference.com/w/cpp/io/basic_syncbuf/set_emit_on_sync): changes the current emit-on-sync policy (public member function of `std::basic_syncbuf<CharT,Traits,Allocator>`)

---
Attribution: content from https://en.cppreference.com/w/cpp/io/manip/emit_on_flush (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.