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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.