std::basic_osyncstream - cppreference.com (original) (raw)

The class template std::basic_osyncstream is a convenience wrapper for std::basic_syncbuf. It provides a mechanism to synchronize threads writing to the same stream.

It can be used with a named variable:

{ std::osyncstream synced_out(std::cout); // synchronized wrapper for std::cout synced_out << "Hello, "; synced_out << "World!"; synced_out << std::endl; // flush is noted, but not yet performed synced_out << "and more!\n"; } // characters are transferred and std::cout is flushed

as well as with a temporary:

std::osyncstream(std::cout) << "Hello, " << "World!" << '\n';

It provides the guarantee that all output made to the same final destination buffer (std::cout in the examples above) will be free of data races and will not be interleaved or garbled in any way, as long as every write to that final destination buffer is made through (possibly different) instances of std::basic_osyncstream.

Typical implementation of std::basic_osyncstream holds only one member: the wrapped std::basic_syncbuf.

Inheritance diagram

Several typedefs for common character types are provided:

Contents

• 1 Member types
• 2 Member functions
• 3 Inherited from std::basic_ostream
  • 3.1 Member functions
    * 3.1.1 Formatted output
    * 3.1.2 Unformatted output
    * 3.1.3 Positioning
    * 3.1.4 Miscellaneous
  • 3.2 Member classes
• 4 Inherited from std::basic_ios
  • 4.1 Member types
  • 4.2 Member functions
    * 4.2.1 State functions
    * 4.2.2 Formatting
    * 4.2.3 Miscellaneous
• 5 Inherited from std::ios_base
  • 5.1 Member functions
    * 5.1.1 Formatting
    * 5.1.2 Locales
    * 5.1.3 Internal extensible array
    * 5.1.4 Miscellaneous
    * 5.1.5 Member classes
  • 5.2 Member types and constants
  • 5.3 Notes

[edit] Member types

[edit] Member functions

Inherited from std::basic_ostream

Member functions

Member classes

| | implements basic logic for preparation of the stream for output operations (public member class of std::basic_ostream<CharT,Traits>) [edit] | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

Inherited from std::basic_ios

Member types

Member functions

State functions
good	checks if no error has occurred i.e. I/O operations are available (public member function of std::basic_ios<CharT,Traits>) [edit]
eof	checks if end-of-file has been reached (public member function of std::basic_ios<CharT,Traits>) [edit]
fail	checks if an error has occurred (public member function of std::basic_ios<CharT,Traits>) [edit]
bad	checks if a non-recoverable error has occurred (public member function of std::basic_ios<CharT,Traits>) [edit]
operator!	checks if an error has occurred (synonym of fail()) (public member function of std::basic_ios<CharT,Traits>) [edit]
operator bool	checks if no error has occurred (synonym of ) (public member function of std::basic_ios<CharT,Traits>) [edit]
rdstate	returns state flags (public member function of std::basic_ios<CharT,Traits>) [edit]
setstate	sets state flags (public member function of std::basic_ios<CharT,Traits>) [edit]
clear	modifies state flags (public member function of std::basic_ios<CharT,Traits>) [edit]
Formatting
copyfmt	copies formatting information (public member function of std::basic_ios<CharT,Traits>) [edit]
fill	manages the fill character (public member function of std::basic_ios<CharT,Traits>) [edit]
Miscellaneous
exceptions	manages exception mask (public member function of std::basic_ios<CharT,Traits>) [edit]
imbue	sets the locale (public member function of std::basic_ios<CharT,Traits>) [edit]
rdbuf	manages associated stream buffer (public member function of std::basic_ios<CharT,Traits>) [edit]
tie	manages tied stream (public member function of std::basic_ios<CharT,Traits>) [edit]
narrow	narrows characters (public member function of std::basic_ios<CharT,Traits>) [edit]
widen	widens characters (public member function of std::basic_ios<CharT,Traits>) [edit]

Inherited from std::ios_base

Member functions

[edit] Notes