std::basic_filebuf<CharT,Traits>::open

basic_filebuf* open( const char* s, std::ios_base::openmode mode );

basic_filebuf* open( const std::string& str, std::ios_base::openmode mode );

basic_filebuf* open( const std::filesystem::path& p,
                     std::ios_base::openmode mode );

basic_filebuf* open( const std::filesystem::path::value_type* s,
                     std::ios_base::openmode mode );

Если связанный файл уже открыт (is_open() != false), немедленно возвращается нулевой указатель.

В противном случае открывает файл с заданным именем (s, p.c_str()(начиная с C++17) или str.c_str(), в зависимости от перегрузки). Значения std::ios_base::openmode можно записывать, например, как std::ios_base::out | std::ios_base::app.

Файл открывается так, как если бы вызывался std::fopen со вторым аргументом (режимом доступа к файлу), определяемым результатом mode & ~std::ios_base::ate следующим образом; open() завершается ошибкой, если результат не является одной из комбинаций флагов, показанных в таблице:

Если операция открытия завершается успешно и (openmode & std::ios_base::ate) != 0 (установлен бит ate), позиция в файле перемещается в конец файла, как если бы вызывался std::fseek(file, 0, SEEK_END), где file — указатель, возвращаемый вызовом std::fopen. Если перемещение не удаётся, вызывается close() и возвращается нулевой указатель, указывающий на ошибку.

Параметры

Возвращаемое значение

this в случае успеха, нулевой указатель в случае ошибки.

Примечания

open() обычно вызывается через конструктор или функцию-член open() класса std::basic_fstream.

Пример

#include <fstream>
#include <iostream>

int main()
{
    std::string filename = "Test.b";
    std::filebuf fb;
    
    // prepare a file to read
    double d = 3.14;
    if (!fb.open(filename, std::ios::binary | std::ios::out))
    {
        std::cout << "Open file " << filename << " for write failed\n";
        return 1;
    } 
    fb.sputn(reinterpret_cast<char*>(&d), sizeof d);
    fb.close();
    
    // open file for reading
    double d2 = 0.0;
    if (!fb.open(filename, std::ios::binary | std::ios::in))
    {
        std::cout << "Open file " << filename << " for read failed\n";
        return 1;
    }
    
    auto got = fb.sgetn(reinterpret_cast<char*>(&d2), sizeof d2);
    if (sizeof(d2) != got)
        std::cout << "Read of " << filename << " failed\n";
    else
        std::cout << "Read back from file: " << d2 << '\n';
}

Read back from file: 3.14

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были ретроактивно применены к ранее опубликованным стандартам C++.

См. также