29 Input/output library [input.output]

29.9 File-based streams [file.streams]

29.9.4 Class template basic_­ofstream [ofstream]

29.9.4.1 General [ofstream.general]

namespace std { template<class charT, class traits = char_traits<charT>> class basic_ofstream : public basic_ostream<charT, traits> { public: using char_type = charT; using int_type = typename traits::int_type; using pos_type = typename traits::pos_type; using off_type = typename traits::off_type; using traits_type = traits; // [ofstream.cons], constructors basic_ofstream(); explicit basic_ofstream(const char* s, ios_base::openmode mode = ios_base::out); explicit basic_ofstream(const filesystem::path::value_type* s, // wide systems only; see [fstream.syn] ios_base::openmode mode = ios_base::out); explicit basic_ofstream(const string& s, ios_base::openmode mode = ios_base::out); explicit basic_ofstream(const filesystem::path& s, ios_base::openmode mode = ios_base::out); basic_ofstream(const basic_ofstream&) = delete; basic_ofstream(basic_ofstream&& rhs); // [ofstream.assign], assign and swap basic_ofstream& operator=(const basic_ofstream&) = delete; basic_ofstream& operator=(basic_ofstream&& rhs); void swap(basic_ofstream& rhs); // [ofstream.members], members basic_filebuf<charT, traits>* rdbuf() const; bool is_open() const; void open(const char* s, ios_base::openmode mode = ios_base::out); void open(const filesystem::path::value_type* s, ios_base::openmode mode = ios_base::out); // wide systems only; see [fstream.syn] void open(const string& s, ios_base::openmode mode = ios_base::out); void open(const filesystem::path& s, ios_base::openmode mode = ios_base::out); void close(); private: basic_filebuf<charT, traits> sb; // exposition only }; template<class charT, class traits> void swap(basic_ofstream<charT, traits>& x, basic_ofstream<charT, traits>& y); }
The class basic_­ofstream<charT, traits> supports writing to named files.
It uses a basic_­filebuf<​charT, traits> object to control the associated sequence.
For the sake of exposition, the maintained data is presented here as:

29.9.4.2 Constructors [ofstream.cons]

basic_ofstream();
Effects: Initializes the base class with basic_­ostream<charT, traits>(addressof(sb)) ([ostream.cons]) and sb with basic_­filebuf<charT, traits>() ([filebuf.cons]).
explicit basic_ofstream(const char* s, ios_base::openmode mode = ios_base::out); explicit basic_ofstream(const filesystem::path::value_type* s, ios_base::openmode mode = ios_base::out); // wide systems only; see [fstream.syn]
Effects: Initializes the base class with basic_­ostream<charT, traits>(addressof(sb)) ([ostream.cons]) and sb with basic_­filebuf<charT, traits>() ([filebuf.cons]), then calls rdbuf()->open(s, mode | ios_­base​::​out).
If that function returns a null pointer, calls setstate(​failbit).
explicit basic_ofstream(const string& s, ios_base::openmode mode = ios_base::out); explicit basic_ofstream(const filesystem::path& s, ios_base::openmode mode = ios_base::out);
Effects: Equivalent to: basic_­ofstream(s.c_­str(), mode).
basic_ofstream(basic_ofstream&& rhs);
Effects: Move constructs the base class, and the contained basic_­filebuf.
Then calls basic_­ostream<charT, traits>​::​set_­rdbuf(​addressof(sb)) to install the contained basic_­filebuf.

29.9.4.3 Assignment and swap [ofstream.assign]

void swap(basic_ofstream& rhs);
Effects: Exchanges the state of *this and rhs by calling basic_­ostream<charT, traits>​::​swap(rhs) and sb.swap(rhs.sb).
template<class charT, class traits> void swap(basic_ofstream<charT, traits>& x, basic_ofstream<charT, traits>& y);
Effects: Equivalent to: x.swap(y).

29.9.4.4 Member functions [ofstream.members]

basic_filebuf<charT, traits>* rdbuf() const;
Returns: const_­cast<basic_­filebuf<charT, traits>*>(addressof(sb)).
bool is_open() const;
Returns: rdbuf()->is_­open().
void open(const char* s, ios_base::openmode mode = ios_base::out); void open(const filesystem::path::value_type* s, ios_base::openmode mode = ios_base::out); // wide systems only; see [fstream.syn]
Effects: Calls rdbuf()->open(s, mode | ios_­base​::​out).
If that function does not return a null pointer calls clear(), otherwise calls setstate(​failbit) (which may throw ios_­base​::​failure) ([iostate.flags]).
void close();
Effects: Calls rdbuf()->close() and, if that function fails (returns a null pointer), calls setstate(​failbit) (which may throw ios_­base​::​failure) ([iostate.flags]).
void open(const string& s, ios_base::openmode mode = ios_base::out); void open(const filesystem::path& s, ios_base::openmode mode = ios_base::out);
Effects: Calls open(s.c_­str(), mode).