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

CKTIS / C++

std::ifstream : flux d’entrée de fichier

std::ifstream relie les opérations d’entrée de caractères à un fichier et conserve formatage, EOF et erreurs.

Version : C++23

Syntaxe

using std::ifstream = std::basic_ifstream<char>;

explicit std::ifstream(const char* path,
    std::ios_base::openmode mode = std::ios_base::in);
explicit std::ifstream(const std::filesystem::path& path,
    std::ios_base::openmode mode = std::ios_base::in);

void open(const std::filesystem::path& path,
    std::ios_base::openmode mode = std::ios_base::in);
void close();
bool is_open() const;

std::ifstream de <fstream> est l’alias std::basic_ifstream<char>. Il contient un std::basic_filebuf et hérite les entrées formatées et non formatées de std::basic_istream. Son constructeur ou open ajoute std::ios::in au mode demandé ; std::ios::binary désactive les traductions de mode texte de la plateforme lorsqu’elles existent. Un std::filesystem::path peut nommer le fichier.

L’exemple crée d’abord un fichier contenant 12 cyan, puis l’ouvre avec std::ifstream, extrait un nombre et un mot et affiche 12 cyan. Le test if (!input) valide l’extraction ; un close explicite précède la suppression.

Un échec d’ouverture positionne failbit. is_open() indique l’association du tampon, tandis que operator bool, fail(), bad() et eof() décrivent les opérations. std::ios_base::failure n’est lancé que pour les bits de exceptions(). Après EOF, appelez clear() avant un nouveau seekg si l’état le bloque. Le flux est déplaçable, non copiable. Le destructeur ferme, mais utilisez close et contrôlez l’état pour diagnostiquer sa défaillance.

Exemples

#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>

int main() {
    const std::filesystem::path path = "cpp-ref-015-ifstream.txt";
    {
        std::ofstream output(path);
        output << "12 cyan\n";
    }

    std::ifstream input(path);
    int number{};
    std::string word;
    input >> number >> word;
    if (!input) return 1;
    std::cout << number << ' ' << word << '\n';
    input.close();
    std::filesystem::remove(path);
}

Résultat

12 cyan

std::ifstream → 12 cyan

Sources