CKTIS / C++
std::fstream: obojsmerný súborový prúd
std::fstream spája znakový vstup aj výstup s pomenovaným súborom a uchováva formátovanie a chybový stav.
Verzia: C++23
Syntax
using std::fstream = std::basic_fstream<char>;
explicit std::fstream(const char* path,
std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
explicit std::fstream(const std::string& path,
std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
void open(const std::filesystem::path& path,
std::ios_base::openmode mode = std::ios_base::in | std::ios_base::out);
void close();
bool is_open() const;std::fstream z <fstream> je alias std::basic_fstream<char> a dedí vstupné aj výstupné operácie z std::basic_iostream. Vložený std::basic_filebuf viaže prúd k súboru. Konštruktor a open implicitne žiadajú std::ios::in | std::ios::out; explicitné príznaky std::ios::trunc, std::ios::app a std::ios::binary určujú režim otvorenia.
Príklad otvorí súbor na čítanie aj zápis s std::ios::trunc, zapíše 42 blue, vyprázdni buffer cez flush, nastaví čítaciu pozíciu na začiatok pomocou seekg(0) a načíta číslo a slovo. Preto vypíše 42 blue. Blok zavrie prúd pred std::filesystem::remove; produkčný kód má kontrolovať aj zlyhanie zatvorenia alebo povoliť výnimky pre zvolené stavové bity.
Neúspešné otvorenie nastaví failbit. is_open() hlási len väzbu buffera, kým operator bool, fail() a bad() opisujú stav operácií. std::ios_base::failure sa vyhodí iba pre bity z exceptions(). Po EOF treba stav pred ďalším presunom vyčistiť; pri striedaní zápisu a čítania spresnia pozíciu explicitné flush a seekg/seekp. Prúd možno presunúť, nie kopírovať. Textový režim môže prekladať konce riadkov; binárne dáta vyžadujú std::ios::binary.
Príklady
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
int main() {
const std::filesystem::path path = "cpp-ref-014-fstream.txt";
{
std::fstream file(path, std::ios::in | std::ios::out | std::ios::trunc);
if (!file) return 1;
file << 42 << ' ' << "blue";
file.flush();
file.seekg(0);
int number{};
std::string word;
file >> number >> word;
if (!file) return 2;
std::cout << number << ' ' << word << '\n';
}
std::filesystem::remove(path);
}
Výsledok
42 blue
std::fstream → 42 blue