CKTIS / C++
std::basic_ostream::flush — synchronizacja bufora wyjściowego
std::basic_ostream::flush żąda synchronizacji bufora strumienia i zwraca referencję do tego samego strumienia. Nie dopisuje znaku nowej linii; niepowodzenie synchronizacji sygnalizuje przez badbit.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush jest niesformatowaną funkcją wyjściową, wywoływaną jako os.flush(). Zwraca *this, co umożliwia łączenie operacji. Sama nie dopisuje znaków.
Jeśli rdbuf() nie jest pustym wskaźnikiem, tworzy obiekt sentry. Gdy ten zezwala na operację, wywołuje rdbuf()->pubsync(). Wynik -1 powoduje setstate(badbit), co zależnie od maski wyjątków może rzucić std::ios_base::failure. Gdy sentry nie zezwala na operację, synchronizacja jest pomijana.
os << std::flush wywołuje tę samą funkcję składową. std::endl dodatkowo wstawia znak nowej linii przed jej wywołaniem. Synchronizacja zależy od rodzaju bufora: nie należy utożsamiać jej z gwarancją trwałego zapisu na fizycznym nośniku.
Przykład używa własnego bufora, którego sync() zlicza wywołania i zwraca sukces. Nawet bez zapisanych znaków out.flush() wywołuje synchronizację; oczekiwany wynik to 1 i znak nowej linii.
Przykłady
#include <iostream>
#include <ostream>
#include <streambuf>
class CountingBuffer : public std::streambuf {
public:
int sync_calls = 0;
protected:
int sync() override {
++sync_calls;
return 0;
}
};
int main() {
CountingBuffer buffer;
std::ostream out(&buffer);
out.flush();
std::cout << buffer.sync_calls << '\n';
}
Wynik
1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.