# std::basic_syncbuf<CharT,Traits,Allocator>::set_emit_on_sync

> C++ Atlas: `cppatlas.com/w/cpp/io/basic_syncbuf/set_emit_on_sync` | Source: https://en.cppreference.com/w/cpp/io/basic_syncbuf/set_emit_on_sync | Domain: Input/output | Standards: C++20

Changes the current emit-on-sync policy.

## Official Specification Summary (cppreference)

```cpp
void set_emit_on_sync( bool b ) noexcept;
```

Changes the current emit-on-sync policy.

The value `false` (the default) indicates that any flush will be postponed until a call to emit.

The value `true` makes flushes apply immediately.

### Parameters

- `b` - new value for the emit-on-sync policy

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`sync`](https://en.cppreference.com/w/cpp/io/basic_streambuf/pubsync) [virtual]: synchronizes the buffers with the associated character sequence (virtual protected member function of `std::basic_streambuf<CharT,Traits>`)
- [`emit`](https://en.cppreference.com/w/cpp/io/basic_syncbuf/emit): atomically transmits the entire internal buffer to the wrapped streambuf (public member function)
- [`emit_on_flush`](https://en.cppreference.com/w/cpp/io/manip/emit_on_flush) (C++20), [`noemit_on_flush`](https://en.cppreference.com/w/cpp/io/manip/emit_on_flush): controls whether a stream's `basic_syncbuf` emits on flush (function template)

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