std::basic_ofstream<CharT,Traits>::open
< cpp | io | basic ofstream
| void open( const char *filename, ios_base::openmode mode = ios_base::out ); |
(1) | |
| void open( const std::filesystem::path::value_type *filename, ios_base::openmode mode = ios_base::out ); |
(2) | (since C++17) |
| void open( const std::string &filename, ios_base::openmode mode = ios_base::out ); |
(3) | (since C++11) |
| void open( const std::filesystem::path &filename, ios_base::openmode mode = ios_base::out ); |
(4) | (since C++17) |
Opens and associates the file with name filename with the file stream.
Calls setstate(failbit) on failure.
| Calls clear() on success. | (since C++11) |
1-2) Effectively calls rdbuf()->open(filename, mode | ios_base::out). (see std::basic_filebuf::open for the details on the effects of that call). Overload (2) is only provided if std::filesystem::path::value_type is not char. (since C++17)
3-4) Effectively calls (1-2) as if by open(filename.c_str(), mode).
Parameters
| filename | - | the name of the file to be opened | ||||||||||||||
| mode | - | specifies stream open mode. It is bitmask type, the following constants are defined:
|
Return value
(none)
Example
| This section is incomplete Reason: no example |
See also
| checks if the stream has an associated file (public member function) | |
| closes the associated file (public member function) | |
| opens a file and configures it as the associated character sequence (public member function of std::basic_filebuf<CharT,Traits>) |