std::basic_osyncstream<CharT,Traits,Allocator>::emit (3) - Linux Manuals

std::basic_osyncstream<CharT,Traits,Allocator>::emit: std::basic_osyncstream<CharT,Traits,Allocator>::emit

NAME

std::basic_osyncstream<CharT,Traits,Allocator>::emit - std::basic_osyncstream<CharT,Traits,Allocator>::emit

Synopsis

void emit();

Emits all buffered output and executes any pending flushes, by calling emit() on the underlying std::basic_syncbuf.

Parameters

(none)

Example

// Run this code

  #include <syncstream>
  #include <iostream>
  int main()
  {
    {
      std::osyncstream bout(std::cout);
      std::bout << "Hello," << '\n'; // no flush
      std::bout.emit(); // characters transferred; cout not flushed
      std::bout << "World!" << std::endl; // flush noted; cout not flushed
      std::bout.emit(); // characters transferred; cout flushed
      std::bout << "Greetings." << '\n'; // no flush
    } // destructor calls emit(): characters transferred; cout not flushed

    // emit can be used for local exception-handling on the wrapped stream
    std::osyncstream bout(std::cout);
    bout << "Hello, " << "World!" << '\n';
    try {
      bout.emit();
    } catch (...) {
      // handle exceptions
    }
  }

Output:

  Hello,
  World!
  Greetings.
  Hello, World!