Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::fstream: dvosmjerni datotečni tok

std::fstream povezuje znakovni ulaz i izlaz s imenovanom datotekom te čuva formatiranje i stanje pogreške.

Verzija: 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> alias je za std::basic_fstream<char> i nasljeđuje ulazne i izlazne operacije od std::basic_iostream. Sadržani std::basic_filebuf povezuje tok s datotekom. Konstruktor i open zadano traže std::ios::in | std::ios::out; izričite zastavice std::ios::trunc, std::ios::app i std::ios::binary određuju način otvaranja.

Primjer otvara za čitanje i pisanje s std::ios::trunc, zapisuje 42 blue, prazni međuspremnik pozivom flush, vraća položaj čitanja na početak s seekg(0) i čita broj i riječ. Zato ispisuje 42 blue. Blok zatvara tok prije std::filesystem::remove; produkcijski kod treba provjeriti i neuspjeh zatvaranja ili uključiti iznimke za odabrane bitove stanja.

Neuspjelo otvaranje postavlja failbit. is_open() govori samo o vezi međuspremnika, dok operator bool, fail() i bad() opisuju stanje operacija. std::ios_base::failure baca se samo za bitove u exceptions(). Nakon EOF-a treba očistiti stanje prije novog pozicioniranja; pri izmjeni pisanja i čitanja izričiti flush i seekg/seekp uklanjaju dvojbu položaja. Tok je premjestiv, ne kopirljiv. Tekstni način može prevoditi završetke redaka; binarni podaci zahtijevaju std::ios::binary.

Primjeri

#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

Izvori