public member function
<fstream>

std::basic_ofstream::basic_ofstream

default (1)
basic_ofstream();
initialization (2)
explicit basic_ofstream (const char* filename,
                         ios_base::openmode mode = ios_base::out);
default (1)
basic_ofstream();
initialization (2)
explicit basic_ofstream (const char* filename,
                         ios_base::openmode mode = ios_base::out);
explicit basic_ofstream (const string& filename,
                         ios_base::openmode mode = ios_base::out);
copy (3)
basic_ofstream (const basic_ofstream&) = delete;
move (4)
basic_ofstream (basic_ofstream&& x);
Construct object
Constructs a basic_ofstream object:

(1) default constructor
Constructs a basic_ofstream object that is not associated with any file.
Internally, its basic_ostream base constructor is passed a pointer to a newly constructed basic_filebuf object (the internal file stream buffer).
(2) initialization constructor
Constructs a basic_ofstream object, initially associated with the file identified by its first argument (filename), open with the mode specified by mode.
Internally, its basic_ostream base constructor is passed a pointer to a newly constructed basic_filebuf object (the internal file stream buffer). Then, basic_filebuf::open is called with filename and mode as arguments.
If the file cannot be opened, the stream's failbit flag is set.
(3) copy constructor (deleted)
Deleted (no copy constructor).
(4) move constructor
Acquires the contents of x.
First, the function move-constructs both its base basic_ostream class from x and a basic_filebuf object from x's internal basic_filebuf object, and then associates them by calling member set_rdbuf.
x is left in an unspecified but valid state.
The internal basic_filebuf object has at least the same duration as the basic_ofstream object.

Parameters

filename
A string representing the name of the file to be opened.
Specifics about its format and validity depend on the library implementation and running environment.
mode
Flags describing the requested input/output mode for the file.
This is an object of the bitmask member type openmode that consists of a combination of the following member constants:
member constantstands foraccess
ininputFile open for reading: the internal stream buffer supports input operations.
out *outputFile open for writing: the internal stream buffer supports output operations.
binarybinaryOperations are performed in binary mode rather than text.
ateat endThe output position starts at the end of the file.
appappendAll output operations happen at the end of the file, appending to its existing contents.
trunctruncateAny contents that existed in the file before it is open are discarded.
These flags can be combined with the bitwise OR operator (|).
* out is always set for basic_ofstream objects (even if explicitly not set in argument mode).
Note that even though basic_ofstream is an output stream, its internal basic_filebuf object may be set to also support input operations.

If the mode has both trunc and app set, the opening operation fails. It also fails if both app and in are set simultaneously.
If the mode has both trunc and app set, the opening operation fails.
x
A basic_ofstream object of the same type (with the same class template parameters charT and traits), whose value is moved.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
// ofstream constructor.
#include <fstream>      // std::ofstream

int main () {

  std::ofstream ofs ("test.txt", std::ofstream::out);

  ofs << "lorem ipsum";

  ofs.close();

  return 0;
}


Data races

The move constructor (4) modifies x.

Exception safety

-

See also