basic_ofstream Class

Describes an object that controls insertion of elements and encoded objects into a stream buffer of class basic_filebuf<Elem, Tr>, with elements of type Elem, whose character traits are determined by the class Tr.

template <class Elem, class Tr = char_traits<Elem> >
    class basic_ofstream : public basic_ostream<Elem, Tr>

Parameters

• Elem
  The basic element of the file buffer.

• Tr
  The traits of the basic element of the file buffer (usually char_traits<Elem>).

Remarks

When the wchar_t specialization of basic_ofstream writes to the file, if the file is opened in text mode it will write a MBCS sequence. The internal representation will use a buffer of wchar_t characters.

The object stores an object of class basic_filebuf<Elem, Tr>.

Example

The following example shows how to create a basic_ofstream object and write text to it.

// basic_ofstream_class.cpp
// compile with: /EHsc
#include <fstream>

using namespace std;

int main(int argc, char **argv)
{
    ofstream ofs("ofstream.txt");
    if (!ofs.bad())
    {
        ofs << "Writing to a basic_ofstream object..." << endl;
        ofs.close();
    }
}

Constructors

basic_ofstream

Creates an object of type basic_ofstream.

Member Functions

close	Closes a file.
is_open	Determines if a file is open.
open	Opens a file.
rdbuf	Returns the address of the stored stream buffer.
swap	Exchange the contents of this basic_ofstream for the contents of the provided basic_ofstream.

Operators

operator=

Assigns the content of this stream object. This is a move assignment involving an rvalue reference that does not leave a copy behind.

Requirements

Header: <fstream>

Namespace: std

See Also

Reference

basic_ostream Class

Thread Safety in the C++ Standard Library

iostream Programming

iostreams Conventions