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

CKTIS / C++

std::ifstream: fluxo de entrada de ficheiro

std::ifstream liga operações de entrada de caracteres a um ficheiro e mantém formatação, EOF e erros.

Versão: C++23

Sintaxe

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> é o alias std::basic_ifstream<char>. Contém um std::basic_filebuf e herda entrada formatada e não formatada de std::basic_istream. O construtor ou open acrescenta std::ios::in ao modo pedido; std::ios::binary desativa traduções textuais da plataforma quando aplicável. Um std::filesystem::path pode indicar o ficheiro.

O exemplo cria primeiro um ficheiro com 12 cyan, abre-o por std::ifstream, extrai um número e uma palavra e imprime 12 cyan. if (!input) valida a extração e um close explícito antecede a remoção.

Falha ao abrir define failbit; is_open() indica associação do buffer, enquanto operator bool, fail(), bad() e eof() descrevem operações. std::ios_base::failure só é lançada para bits ativos em exceptions(). Após EOF chama clear() antes de novo seekg se o estado o impedir. O fluxo é movível, não copiável. O destrutor fecha, mas usa close e verifica o estado quando precisas diagnosticar a falha de fecho.

Exemplos

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

Resultado

12 cyan

std::ifstream → 12 cyan

Fontes