Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::ifstream: stream di input da file

std::ifstream collega operazioni di input di caratteri a un file e conserva formato, EOF ed errori.

Versione: C++23

Sintassi

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 da <fstream> è l’alias std::basic_ifstream<char>. Contiene un std::basic_filebuf ed eredita input formattato e non formattato da std::basic_istream. Costruttore o open aggiungono std::ios::in al modo richiesto; std::ios::binary disabilita le traduzioni testuali della piattaforma, dove presenti. Un std::filesystem::path può nominare il file.

L’esempio crea prima un file con 12 cyan, poi lo apre tramite std::ifstream, estrae numero e parola e stampa 12 cyan. Il controllo if (!input) convalida l’estrazione; un close esplicito precede la rimozione.

Un’apertura fallita imposta failbit; is_open() indica l’associazione del buffer, mentre operator bool, fail(), bad() ed eof() descrivono lo stato operativo. std::ios_base::failure è lanciata solo per bit abilitati in exceptions(). Dopo EOF chiama clear() prima di un nuovo seekg se lo stato lo blocca. Lo stream è spostabile, non copiabile. Il distruttore chiude, ma usa close e controlla lo stato per diagnosticare errori di chiusura.

Esempi

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

Risultato

12 cyan

std::ifstream → 12 cyan

Fonti