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

Sincroniza el búfer de entrada con la fuente de datos asociada.

Se comporta como una UnformattedInputFunction , excepto que gcount() no se ve afectada. Después de construir y verificar el objeto centinela,

Si rdbuf() es un puntero nulo, retorna - 1 .

De lo contrario, llama a rdbuf ( ) - > pubsync ( ) . Si esa función retorna - 1 , llama a setstate ( badbit ) y retorna - 1 . De lo contrario, retorna ​ 0 ​ .

Parámetros

(ninguno)

Valor de retorno

​ 0 ​ en caso de éxito, - 1 en caso de fallo o si el flujo no admite esta operación (no tiene búfer).

Notas

Al igual que con readsome() , está definido por la implementación si esta función hace algo con los flujos proporcionados por la biblioteca. La intención típica es que la siguiente operación de lectura recoja cualquier cambio que se haya realizado en la secuencia de entrada asociada después de que el búfer de flujo llenó por última vez su área de obtención. Para lograr eso, sync() puede vaciar el área de obtención, o puede rellenarla, o puede no hacer nada. Una excepción notable es Visual Studio, donde esta operación descarta la entrada no procesada cuando se llama con un flujo de entrada estándar.

Ejemplo

#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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también