CKTIS / C++
std::ifstream: vhodni datotečni tok
std::ifstream poveže znakovni vhod z datoteko ter hrani stanje oblikovanja, EOF in napak.
Različica: C++23
Sintaksa
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 iz <fstream> je vzdevek std::basic_ifstream<char>. Vsebuje std::basic_filebuf in podeduje oblikovan ter neoblikovan vhod od std::basic_istream. Konstruktor ali open načinu doda std::ios::in; std::ios::binary izklopi morebitne platformne besedilne pretvorbe. Datoteko lahko določi std::filesystem::path.
Primer najprej ustvari datoteko z 12 cyan, jo odpre prek std::ifstream, prebere število in besedo ter izpiše 12 cyan. if (!input) preveri branje, izrecni close pa je pred odstranitvijo datoteke.
Neuspešno odpiranje nastavi failbit; is_open() pove povezavo medpomnilnika, operator bool, fail(), bad() in eof() pa stanje operacije. std::ios_base::failure se sproži le za bite v exceptions(). Po EOF pred ponovnim seekg uporabi clear(), če stanje ovira premik. Tok je premakljiv, ne kopirljiv. Destruktor zapre, toda za diagnostiko napake uporabi close in preveri stanje.
Primeri
#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);
}
Rezultat
12 cyan
std::ifstream → 12 cyan