std::basic_ofstream<CharT,Traits>::basic_ofstream

basic_ofstream();	(1)
explicit basic_ofstream( const char* filename, std::ios_base::openmode mode = std::ios_base::out );	(2)
explicit basic_ofstream( const std::filesystem::path::value_type* filename, std::ios_base::openmode mode = std::ios_base::out );	(3)	(с C++17)
explicit basic_ofstream( const std::string& filename, std::ios_base::openmode mode = std::ios_base::out );	(4)	(с C++11)
template< class FsPath > explicit basic_ofstream( const FsPath& filename, std::ios_base::openmode mode = std::ios_base::out );	(5)	(с C++17)
basic_ofstream( basic_ofstream&& other );	(6)	(с C++11)
basic_ofstream( const basic_ofstream& rhs ) = delete;	(7)	(с C++11)

Создаёт новый поток файла.

1) Конструктор по умолчанию: создаёт поток, не связанный с файлом: по умолчанию инициализирует std::basic_filebuf и создаёт базовый класс с указателем на этот инициализированный по умолчанию член std::basic_filebuf.

2,3) Сначала выполняет те же шаги, что и конструктор по умолчанию, затем связывает поток с файлом, вызывая rdbuf()->open(filename, mode | std::ios_base::out) (см. std::basic_filebuf::open для подробностей об эффектах этого вызова). Если вызов open() возвращает нулевой указатель, устанавливает setstate(failbit). Перегрузка (3) предоставляется только в том случае, если std::filesystem::path::value_type не является char.(с C++17)

4,5) То же, что и basic_ofstream(filename.c_str(), mode). (5) участвует в разрешении перегрузки только в том случае, если FsPath является std::filesystem::path.(с C++17) Обратите внимание, что, несмотря на то, что режим по умолчанию — out, эффекты идентичны эффектам out | trunc, как описано в std::filebuf::open

6) Конструктор перемещения. Сначала выполняется перемещающее копирование базового класса из other (что не влияет на указатель rdbuf()), затем выполняется перемещающее копирование члена std::basic_filebuf, затем вызывается this->set_rdbuf() для установки нового basic_filebuf в качестве указателя rdbuf() в базовом классе.

7) Конструктор копирования удалён: этот класс не копируется.

Параметры

filename - имя файла для открытия

mode

определяет режим открытия потока. Можно использовать следующие константы и побитовое ИЛИ между ними:

Константа	Объяснение
`app`	перейти к концу потока перед каждым записью
`binary`	открыть в двоичном режиме
`in`	открыть для чтения
`out`	открыть для записи
`trunc`	очистить содержимое потока при открытии
`ate`	перейти к концу потока сразу после открытия
`noreplace` (C++23)	открыть в эксклюзивном режиме

other - другой поток файла, используемый в качестве источника

Пример

#include <fstream>
#include <string>
#include <utility>
 
int main()
{
    std::ofstream f0;
    std::ofstream f1("test.bin", std::ios::binary);
    std::string name = "example.txt";
    std::ofstream f2(name);
    std::ofstream f3(std::move(f1));
}

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

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

DR	Применено к	Поведение, как опубликовано	Корректное поведение
LWG 3430	C++17	`std::filesystem::path` перегрузка привела к нежелательным преобразованиям	избегается путём создания шаблона

См. также

open	открывает файл и связывает его со потоком (публичный член-функция)
open	открывает файл и настраивает его в качестве связанной последовательности символов (публичный член-функция `std::basic_filebuf<CharT,Traits>`)
set_rdbuf	заменяет `rdbuf` без очистки состояния ошибок (защищённый член-функция)
(constructor)	создаёт объект (публичный член-функция `std::basic_ostream<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_ofstream/basic_ofstream