Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła