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

 

哋它亢++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (哋它亢++20)

Language support library

Concepts library (哋它亢++20)

Metaprogramming library (哋它亢++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (哋它亢++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (哋它亢++17)

Regular expressions library (哋它亢++11)

Concurrency support library (哋它亢++11)

Technical specifications

Symbols index

External libraries

 

Input/output library

I/O manipulators

Print functions (哋它亢++23)

C-style I/O

Buffers

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (哋它亢++23)

strstreambuf (哋它亢++98/26*)

basic_syncbuf (哋它亢++20)

Streams

Abstractions

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

File I/O

basic_ifstream

basic_ofstream

basic_fstream

String I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array I/O

basic_ispanstream (哋它亢++23)

basic_ospanstream (哋它亢++23)

basic_spanstream (哋它亢++23)

istrstream (哋它亢++98/26*)

ostrstream (哋它亢++98/26*)

strstream (哋它亢++98/26*)

Synchronized Output

basic_osyncstream (哋它亢++20)

Types

streamoff

streamsize

fpos

Error category interface

iostream_category (哋它亢++11)

io_errc (哋它亢++11)

 

std::basic_syncbuf

Public member functions

basic_syncbuf::basic_syncbuf (哋它亢++20)

basic_syncbuf::operator= (哋它亢++20)

basic_syncbuf::~basic_syncbuf (哋它亢++20)

basic_syncbuf::swap (哋它亢++20)

basic_syncbuf::emit (哋它亢++20)

basic_syncbuf::get_wrapped (哋它亢++20)

basic_syncbuf::get_allocator (哋它亢++20)

basic_syncbuf::set_emit_on_sync (哋它亢++20)

Protected member functions

basic_syncbuf::sync (哋它亢++20)

Non-member functions

swap(std::basic_syncbuf) (哋它亢++20)

 

bool emit();

Atomically transmits all pending output to the wrapped stream.

All emit() calls transferring characters to the same wrapped stream buffer object appear to execute in a total order, where each emit() call synchronizes-with subsequent emit() calls in that total order, even if these calls are made through difference instances of std::basic_syncbuf/std::basic_osyncstream. In practice, this means that emit() takes a lock uniquely associated with the wrapped stream object: for example, it could be held in a static hash map where the address of the wrapped stream is used as the key.

If a call had been made to sync since the last call to emit(), then also flushes the wrapped stream by calling pubsync() on it.

Parameters

(none)

Return value

true if all of the following is true:

• there is a wrapped stream (the wrapped streambuf pointer is not null)
• all characters from the temporary storage were successfully sent into the wrapped stream
• the call to pubsync(), if requested, also completed successfully.

Returns false otherwise.

Notes

Normally called by the destructor or move assignment of the owning std::basic_osyncstream, or by std::basic_osyncstream::emit.

See also

(destructor)	destroys the basic_osyncstream and emits its internal buffer (public member function of std::basic_osyncstream<CharT,Traits,Allocator>)
emit	calls emit() on the underlying basic_syncbuf to transmit its internal data to the final destination (public member function of std::basic_osyncstream<CharT,Traits,Allocator>)
(constructor)	constructs a basic_syncbuf object (public member function)