std::basic_istream<CharT,Traits>::sync

int sync();

Синхронизирует буфер ввода со связанным источником данных.

Ведёт себя как функция неформатированного ввода, за исключением того, что gcount() не затрагивается. После создания и проверки объекта sentry

Если rdbuf() является нулевым указателем, возвращает -1.

В противном случае вызывает rdbuf()->pubsync(). Если эта функция возвращает -1, вызывает setstate(badbit) и возвращает -1. В противном случае возвращает 0.

Параметры

(нет)

Возвращаемое значение

0 в случае успеха, -1 в случае ошибки или если поток не поддерживает эту операцию (не имеет буфера).

Примечания

Как и в случае с readsome(), поведение этой функции для потоков, предоставляемых библиотекой, определяется реализацией. Обычно предполагается, что следующая операция чтения получит все изменения, которые могли быть внесены в связанную входную последовательность после того, как буфер потока в последний раз заполнил свою область чтения. Для этого sync() может очистить область чтения, заполнить её заново или ничего не делать. Примечательным исключением является Visual Studio: при вызове для стандартного потока ввода эта операция отбрасывает необработанные входные данные.

Пример

#include <fstream>
#include <iostream>

void file_abc()
{
    std::ofstream f("test.txt");
    f << "abc\n";
}

void file_123()
{
    std::ofstream f("test.txt");
    f << "123\n";
}

int main()
{
    file_abc(); // file now contains "abc"
    std::ifstream f("test.txt");
    std::cout << "Reading from the file\n";
    char c;
    f >> c;
    std::cout << c;
    file_123(); // file now contains "123"
    f >> c;
    std::cout << c;
    f >> c;
    std::cout << c << '\n';
    f.close();

    file_abc(); // file now contains "abc"
    f.open("test.txt");
    std::cout << "Reading from the file, with sync()\n";
    f >> c;
    std::cout << c;
    file_123(); // file now contains "123"
    f.sync();
    f >> c;
    std::cout << c;
    f >> c;
    std::cout << c << '\n';
}

Reading from the file
abc
Reading from the file, with sync()
a23

Сведения об исправленных дефектах

Следующие отчёты об исправлениях, изменяющие поведение, были ретроактивно применены к ранее опубликованным стандартам C++.

См. также