##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::basic_ofstream::open

From cppreference.com
< cpp‎ | io‎ | basic ofstream

[edit template]

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).

### [edit] Parameters

filename | - | the name of the file to be opened
mode | - | specifies stream open mode. It is bitmask type, the following constants are defined:
Constant | Explanation
`app` | seek to the end of stream before each write
`binary` | open in binary mode
`in` | open for reading
`out` | open for writing
`trunc` | discard the contents of the stream when opening
`ate` | seek to the end of stream immediately after open

### [edit] Return value

(none)

### [edit] Example

| This section is incomplete Reason: no example

### [edit] See also

is_open | checks if the stream has an associated file (public member function) [edit]
close | closes the associated file (public member function) [edit]
open | opens a file and configures it as the associated character sequence (public member function of `std::basic_filebuf`) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/io/basic_ofstream/open&oldid=50852"
Category:

- Todo no example