Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::fstream: fluxo de ficheiro bidirecional

std::fstream liga entrada e saída de carateres a um ficheiro nomeado e mantém formatação e estado de erro.

Versão: C++23

Sintaxe

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> é o alias de std::basic_fstream<char> e herda operações de entrada e saída de std::basic_iostream. O std::basic_filebuf interno associa o fluxo ao ficheiro. O construtor e open pedem por omissão std::ios::in | std::ios::out; flags explícitas como std::ios::trunc, std::ios::app e std::ios::binary determinam o modo de abertura.

O exemplo abre para leitura e escrita com std::ios::trunc, escreve 42 blue, descarrega o buffer com flush, coloca a posição de leitura no início com seekg(0) e extrai um número e uma palavra. Por isso imprime 42 blue. O bloco fecha o fluxo antes de std::filesystem::remove; código de produção deve também detetar falhas ao fechar ou ativar exceções para bits de estado escolhidos.

Uma abertura falhada define failbit. is_open() indica apenas a associação do buffer, enquanto operator bool, fail() e bad() descrevem as operações. std::ios_base::failure só é lançada para bits selecionados em exceptions(). Depois de EOF é preciso limpar o estado antes de reposicionar; ao alternar escrita e leitura, flush e seekg/seekp explícitos eliminam ambiguidades da posição. O fluxo pode ser movido, mas não copiado. O modo de texto pode traduzir fins de linha; dados binários exigem std::ios::binary.

Exemplos

#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

Fontes