Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::fstream: dwukierunkowy strumień plikowy

std::fstream łączy wejście i wyjście znakowe z nazwanym plikiem oraz przechowuje stan formatowania i błędów strumienia.

Wersja: C++23

Składnia

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> jest aliasem std::basic_fstream<char> i dziedziczy operacje wejścia oraz wyjścia po std::basic_iostream. Wewnętrzny std::basic_filebuf wiąże strumień z nazwanym plikiem. Konstruktor i open domyślnie żądają std::ios::in | std::ios::out; jawne flagi, takie jak std::ios::trunc, std::ios::app i std::ios::binary, ustalają sposób otwarcia.

Przykład otwiera plik do odczytu i zapisu z std::ios::trunc, zapisuje 42 blue, opróżnia bufor przez flush, ustawia pozycję odczytu na początku przez seekg(0), a następnie odczytuje liczbę i słowo. Dlatego wypisuje 42 blue. Zakres blokowy zamyka strumień przed std::filesystem::remove; w kodzie produkcyjnym należy sprawdzić także wynik zamknięcia lub wymusić wyjątki dla wybranych bitów stanu.

Nieudane otwarcie ustawia failbit; samo is_open() mówi tylko o powiązaniu bufora, natomiast operator bool, fail() i bad() opisują stan operacji. Wyjątek std::ios_base::failure jest zgłaszany tylko dla bitów w masce exceptions(). Po dojściu do EOF trzeba wyczyścić stan przed ponownym pozycjonowaniem, a przy zmianie kierunku między zapisem i odczytem jawne flush oraz seekg/seekp zapobiegają zależności od pozycji bufora. Strumień jest przenoszalny, niekopiowalny; tryb tekstowy może tłumaczyć zakończenia linii, więc dane binarne wymagają std::ios::binary.

Przykłady

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

Wynik

42 blue

std::fstream → 42 blue

Źródła