cppdraft_translate/cppdraft/ofstream.md

[ofstream]

31 Input/output library [input.output]

31.10 File-based streams [file.streams]

31.10.5 Class template basic_ofstream [ofstream]

31.10.5.1 General [ofstream.general]

🔗

namespace std {template<class charT, class traits = char_traits>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; using native_handle_type = typename basic_filebuf<charT, traits>::native_handle_type; // [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); templateexplicit basic_ofstream(const T& s, ios_base::openmode mode = ios_base::out); basic_ofstream(const basic_ofstream&) = delete; basic_ofstream(basic_ofstream&& rhs);

basic_ofstream& operator=(const basic_ofstream&) = delete; basic_ofstream& operator=(basic_ofstream&& rhs); // [ofstream.swap], swapvoid swap(basic_ofstream& rhs); // [ofstream.members], members basic_filebuf<charT, traits>* rdbuf() const; native_handle_type native_handle() const noexcept; 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};}

1

#

The classbasic_ofstream<charT, traits> supports writing to named files.

It uses abasic_filebuf<​charT, traits> object to control the associated sequence.

For the sake of exposition, the maintained data is presented here as:

• (1.1)

sb, the filebuf object.

31.10.5.2 Constructors [ofstream.cons]

🔗

basic_ofstream();

1

#

Effects: Initializes the base class withbasic_ostream<charT, traits>(addressof(sb)) ([ostream.cons]) and sb withbasic_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]](fstream.syn "31.10.1 Header <fstream> synopsis")

2

#

Effects: Initializes the base class withbasic_ostream<charT, traits>(addressof(sb)) ([ostream.cons]) and sb withbasic_filebuf<charT, traits>() ([filebuf.cons]), then callsrdbuf()->open(s, mode | ios_base​::​out).

If that function returns a null pointer, callssetstate(​failbit).

🔗

explicit basic_ofstream(const string& s, ios_base::openmode mode = ios_base::out);

3

#

Effects: Equivalent to basic_ofstream(s.c_str(), mode).

🔗

template<class T> explicit basic_ofstream(const T& s, ios_base::openmode mode = ios_base::out);

4

#

Constraints: is_same_v<T, filesystem​::​path> is true.

5

#

Effects: Equivalent to basic_ofstream(s.c_str(), mode).

🔗

basic_ofstream(basic_ofstream&& rhs);

6

#

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.

31.10.5.3 Swap [ofstream.swap]

🔗

void swap(basic_ofstream& rhs);

1

#

Effects: Exchanges the state of this and rhs by callingbasic_ostream<charT, traits>​::​swap(rhs) andsb*.swap(rhs.sb).

🔗

template<class charT, class traits> void swap(basic_ofstream<charT, traits>& x, basic_ofstream<charT, traits>& y);

2

#

Effects: Equivalent to x.swap(y).

31.10.5.4 Member functions [ofstream.members]

🔗

basic_filebuf<charT, traits>* rdbuf() const;

1

#

Returns: const_cast<basic_filebuf<charT, traits>*>(addressof(sb)).

🔗

native_handle_type native_handle() const noexcept;

2

#

Effects: Equivalent to: return rdbuf()->native_handle();

🔗

bool is_open() const;

3

#

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]](fstream.syn "31.10.1 Header <fstream> synopsis")

4

#

Effects: Callsrdbuf()->open(s, mode | ios_base​::​out).

If that function does not return a null pointer calls clear(), otherwise callssetstate(​failbit) (which may throwios_base​::​failure) ([iostate.flags]).

🔗

void close();

5

#

Effects: Callsrdbuf()->close() and, if that function fails (returns a null pointer), callssetstate(​failbit) (which may throwios_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);

6

#

Effects: Calls open(s.c_str(), mode).