CKTIS / C++
std::ifstream: vstupní souborový stream
std::ifstream spojuje znakový vstup se souborem a uchovává formátovací, EOF a chybový stav.
Verze: 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 z <fstream> je alias std::basic_ifstream<char>. Obsahuje std::basic_filebuf a dědí formátovaný i neformátovaný vstup z std::basic_istream. Konstruktor nebo open přidává k režimu std::ios::in; std::ios::binary vypíná případné platformní textové převody. Soubor lze pojmenovat pomocí std::filesystem::path.
Příklad nejprve vytvoří soubor s 12 cyan, potom jej otevře přes std::ifstream, načte číslo a slovo a vypíše 12 cyan. if (!input) ověří extrakci a explicitní close předchází odstranění souboru.
Neúspěšné otevření nastaví failbit; is_open() hlásí spojení bufferu, kdežto operator bool, fail(), bad() a eof() stav operace. std::ios_base::failure se vyhodí jen pro bity v exceptions(). Po EOF před novým seekg zavolejte clear(), pokud stav brání operaci. Stream lze přesouvat, ne kopírovat. Destruktor zavírá, ale pro diagnostiku chyby použijte close a zkontrolujte stav.
Příklady
#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);
}
Výsledek
12 cyan
std::ifstream → 12 cyan