Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::fstream: obousměrný souborový proud

std::fstream propojuje znakový vstup i výstup s pojmenovaným souborem a uchovává formátování a chybový stav.

Verze: C++23

Syntaxe

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 dědí vstupní i výstupní operace z std::basic_iostream. Vložený std::basic_filebuf váže proud k souboru. Konstruktor a open implicitně žádají std::ios::in | std::ios::out; výslovné příznaky std::ios::trunc, std::ios::app a std::ios::binary určují režim otevření.

Příklad otevře soubor ke čtení i zápisu s std::ios::trunc, zapíše 42 blue, vyprázdní buffer pomocí flush, nastaví čtecí pozici na začátek přes seekg(0) a načte číslo a slovo. Proto vypíše 42 blue. Blok zavře proud před std::filesystem::remove; produkční kód má kontrolovat i selhání zavření nebo povolit výjimky pro vybrané stavové bity.

Neúspěšné otevření nastaví failbit. is_open() hlásí jen vazbu bufferu, zatímco operator bool, fail() a bad() popisují stav operací. std::ios_base::failure se vyhodí jen pro bity z exceptions(). Po EOF je nutné stav před dalším přesunem vyčistit; při střídání zápisu a čtení zpřesní pozici výslovné flush a seekg/seekp. Proud lze přesunout, ne kopírovat. Textový režim může převádět konce řádků; binární data vyžadují std::ios::binary.

Pří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ýsledek

42 blue

std::fstream → 42 blue

Zdroje