Home Original page

protected virtual member function

<streambuf> <iostream>

std::basic_streambuf::sync

Synchronize stream buffer

Virtual function called by the public member function pubsync to synchronize the contents in the buffer with those of the associated character sequence.

Its default behavior in basic_streambuf is to do nothing and return zero (indicating success), but derived classes that use intermediate buffers shall override this behavior to properly synchronize them: basic_filebuf overrides this virtual member function (see basic_filebuf::sync).


Parameters

none

Return Value

Returns zero, which indicates success.
A value of -1 would indicate failure.

Data races

Introduces no data races, but overriden versions in derived classes may.

Exception safety

No-throw guarantee: this default definition never throws exceptions.

See also

basic_streambuf::pubsync
Synchronize stream buffer (public member function)
basic_filebuf::sync
Synchornize buffer (protected virtual member function)