Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::basic_ostream::flush — sincronizar el búfer de salida

std::basic_ostream::flush solicita la sincronización del búfer de un flujo y devuelve una referencia al mismo flujo. No añade un salto de línea; los fallos de sincronización se indican mediante badbit.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

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

std::basic_ostream::flush es una función de salida sin formato, que se llama como os.flush(). Devuelve *this, lo que permite encadenar operaciones. No añade caracteres por sí misma.

Si rdbuf() no es un puntero nulo, se construye un objeto sentry. Cuando este permite la operación, se llama a rdbuf()->pubsync(). Un resultado de -1 provoca setstate(badbit), que puede lanzar std::ios_base::failure dependiendo de la máscara de excepciones. Si sentry no permite la operación, se omite la sincronización.

os << std::flush llama a la misma función miembro. std::endl inserta además un salto de línea antes de llamarla. La sincronización depende del tipo de búfer: no debe equipararse a una garantía de almacenamiento duradero en un medio físico.

El ejemplo usa un búfer personalizado cuyo sync() cuenta las llamadas e indica que se han realizado correctamente. Aunque no haya caracteres almacenados, out.flush() invoca la sincronización; la salida esperada es 1 seguido de un salto de línea.

Ejemplos

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

Resultado

1

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes