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

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!

See also


             destroys the basic_osyncstream and emits its internal buffer
destructor (public member function)
             atomically transmits the entire internal buffer to the wrapped streambuf
emit (public member function of std::basic_syncbuf<CharT,Traits,Allocator>)