CKTIS / C++
std::fstream: flujo de archivo bidireccional
std::fstream conecta entrada y salida de caracteres con un archivo nombrado y mantiene el formato y el estado de error.
Versión: C++23
Sintaxis
using std::fstream = std::basic_fstream<char>;
explicit std::fstream(const char* path,
std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
explicit std::fstream(const std::string& path,
std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
void open(const std::filesystem::path& path,
std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
void close();
bool is_open() const;std::fstream de <fstream> es el alias de std::basic_fstream<char> y hereda las operaciones de entrada y salida de std::basic_iostream. Su std::basic_filebuf interno asocia el flujo con el archivo. El constructor y open solicitan por defecto std::ios::in | std::ios::out; indicadores explícitos como std::ios::trunc, std::ios::app y std::ios::binary determinan el modo de apertura.
El ejemplo abre para leer y escribir con std::ios::trunc, escribe 42 blue, vacía el búfer mediante flush, lleva la posición de lectura al inicio con seekg(0) y extrae un número y una palabra. Por eso imprime 42 blue. El bloque cierra el flujo antes de std::filesystem::remove; el código de producción también debe comprobar fallos al cerrar o habilitar excepciones para bits de estado elegidos.
Una apertura fallida establece failbit. is_open() solo informa de la asociación del búfer, mientras operator bool, fail() y bad() describen las operaciones. std::ios_base::failure solo se lanza para bits activados en exceptions(). Tras alcanzar EOF hay que limpiar el estado antes de reposicionar; al alternar escritura y lectura, flush y seekg/seekp explícitos eliminan ambigüedades de posición. El flujo se puede mover, pero no copiar. El modo texto puede traducir finales de línea; los datos binarios requieren std::ios::binary.
Ejemplos
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
int main() {
const std::filesystem::path path = "cpp-ref-014-fstream.txt";
{
std::fstream file(path, std::ios::in | std::ios::out | std::ios::trunc);
if (!file) return 1;
file << 42 << ' ' << "blue";
file.flush();
file.seekg(0);
int number{};
std::string word;
file >> number >> word;
if (!file) return 2;
std::cout << number << ' ' << word << '\n';
}
std::filesystem::remove(path);
}
Resultado
42 blue
std::fstream → 42 blue