Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::fstream : flux de fichier bidirectionnel

std::fstream relie les entrées et sorties de caractères à un fichier nommé tout en conservant formatage et état d’erreur.

Version : C++23

Syntaxe

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> est l’alias de std::basic_fstream<char> et hérite les opérations d’entrée et de sortie de std::basic_iostream. Son std::basic_filebuf interne associe le flux au fichier nommé. Le constructeur et open demandent par défaut std::ios::in | std::ios::out ; des drapeaux explicites comme std::ios::trunc, std::ios::app et std::ios::binary fixent le mode d’ouverture.

L’exemple ouvre en lecture-écriture avec std::ios::trunc, écrit 42 blue, vide le tampon avec flush, ramène la position de lecture au début par seekg(0), puis extrait un entier et un mot. Il affiche donc 42 blue. La portée du bloc ferme le flux avant std::filesystem::remove ; un programme réel doit aussi diagnostiquer un échec de fermeture ou activer les exceptions pour certains bits d’état.

Un échec d’ouverture positionne failbit. is_open() indique seulement l’association du tampon, tandis que operator bool, fail() et bad() décrivent les opérations. std::ios_base::failure n’est lancé que pour les bits sélectionnés par exceptions(). Après EOF, effacez l’état avant un nouveau positionnement ; lors d’un changement écriture/lecture, un flush puis seekg/seekp explicites rendent la position tamponnée non ambiguë. Le flux est déplaçable mais non copiable. Le mode texte peut convertir les fins de ligne ; les données binaires exigent std::ios::binary.

Exemples

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

Résultat

42 blue

std::fstream → 42 blue

Sources