Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::basic_ostream::flush — synchronizace výstupní vyrovnávací paměti

std::basic_ostream::flush požaduje synchronizaci vyrovnávací paměti proudu a vrací referenci na tentýž proud. Nepřidává znak nového řádku; selhání synchronizace se oznamuje pomocí badbit.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

basic_ostream& flush();
// Usage:
os.flush();

std::basic_ostream::flush je neformátovaná výstupní funkce, která se volá jako os.flush(). Vrací *this, takže lze operace řetězit. Sama nepřidává žádné znaky.

Pokud rdbuf() není nulový ukazatel, vytvoří se objekt sentry. Jestliže tento objekt operaci povolí, zavolá se rdbuf()->pubsync(). Výsledek -1 způsobí volání setstate(badbit), které může podle masky výjimek vyvolat std::ios_base::failure. Pokud sentry operaci nepovolí, synchronizace se přeskočí.

os << std::flush volá tutéž členskou funkci. std::endl navíc před jejím zavoláním vloží znak nového řádku. Synchronizace závisí na typu vyrovnávací paměti; nelze ji považovat za záruku trvalého uložení na fyzickém médiu.

Příklad používá vlastní vyrovnávací paměť, jejíž sync() počítá volání a hlásí úspěch. I když nejsou uloženy žádné znaky, out.flush() synchronizaci vyvolá; očekávaný výstup je 1 následované znakem nového řádku.

Příklady

#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';
}

Výsledek

1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje