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