База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::basic_ostream::flush — синхронизиране на изходния буфер

std::basic_ostream::flush заявява синхронизиране на буфера на поток и връща препратка към същия поток. Не добавя знак за нов ред; неуспешното синхронизиране се съобщава чрез badbit.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

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

std::basic_ostream::flush е неформатирана изходна функция, която се извиква като os.flush(). Тя връща *this, което позволява свързване на операции. Сама по себе си не добавя знаци.

Ако rdbuf() не е нулев указател, се създава обект sentry. Когато той разрешава операцията, се извиква rdbuf()->pubsync(). Резултат -1 задейства setstate(badbit), което в зависимост от маската за изключения може да хвърли std::ios_base::failure. Ако sentry не разрешава операцията, синхронизирането се пропуска.

os << std::flush извиква същата член-функция. std::endl допълнително вмъква знак за нов ред преди извикването ѝ. Синхронизирането зависи от вида на буфера и не бива да се приравнява с гаранция за трайно записване върху физически носител.

Примерът използва собствен буфер, чийто sync() брои извикванията и съобщава за успех. Дори когато няма записани знаци, out.flush() задейства синхронизиране; очакваният изход е 1, последвано от знак за нов ред.

Примери

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

Резултат

1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници