База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::fstream: двупосочен файлов поток

std::fstream свързва знаков вход и изход с именуван файл и пази форматирането и състоянието за грешки.

Версия: C++23

Синтаксис

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 от <fstream> е псевдоним на std::basic_fstream<char> и наследява входни и изходни операции от std::basic_iostream. Вграденият std::basic_filebuf свързва потока с файла. Конструкторът и open по подразбиране искат std::ios::in | std::ios::out; явни флагове като std::ios::trunc, std::ios::app и std::ios::binary определят режима на отваряне.

Примерът отваря за четене и запис с std::ios::trunc, записва 42 blue, изпразва буфера с flush, връща позицията за четене в началото чрез seekg(0) и извлича число и дума. Затова извежда 42 blue. Блокът затваря потока преди std::filesystem::remove; продукционният код трябва да проверява и грешка при затваряне или да включи изключения за избрани битове.

Неуспешното отваряне задава failbit. is_open() показва само връзката на буфера, а operator bool, fail() и bad() описват операциите. std::ios_base::failure се хвърля само за битове в exceptions(). След EOF състоянието трябва да се изчисти преди ново позициониране; при смяна между запис и четене явните flush и seekg/seekp премахват двусмислието. Потокът се премества, но не се копира. Текстовият режим може да преобразува краища на редове; бинарните данни изискват std::ios::binary.

Примери

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

Резултат

42 blue

std::fstream → 42 blue

Източници