Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::fstream: dvosmerni datotečni tok

std::fstream poveže znakovni vhod in izhod z imenovano datoteko ter hrani oblikovanje in stanje napak.

Različica: C++23

Sintaksa

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 iz <fstream> je vzdevek za std::basic_fstream<char> in podeduje vhodne ter izhodne operacije od std::basic_iostream. Vsebovani std::basic_filebuf tok poveže z datoteko. Konstruktor in open privzeto zahtevata std::ios::in | std::ios::out; izrecne zastavice std::ios::trunc, std::ios::app in std::ios::binary določijo način odpiranja.

Primer odpre za branje in pisanje z std::ios::trunc, zapiše 42 blue, izprazni medpomnilnik s flush, nastavi bralni položaj na začetek s seekg(0) ter prebere število in besedo. Zato izpiše 42 blue. Blok zapre tok pred std::filesystem::remove; produkcijska koda naj preveri tudi napake zapiranja ali omogoči izjeme za izbrane bite stanja.

Neuspelo odpiranje nastavi failbit. is_open() sporoča le povezavo medpomnilnika, medtem ko operator bool, fail() in bad() opisujejo operacije. std::ios_base::failure se sproži le za bite v exceptions(). Po EOF je treba pred novim pozicioniranjem počistiti stanje; ob menjavi pisanja in branja izrecni flush ter seekg/seekp odpravijo dvoumnost položaja. Tok je premakljiv, ne kopirljiv. Besedilni način lahko pretvarja konce vrstic; binarni podatki zahtevajo std::ios::binary.

Primeri

#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);
}

Rezultat

42 blue

std::fstream → 42 blue

Viri