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.

For a list of all members of this type, see basic_ofstream Members.

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();
    }
}

Requirements

Header: <fstream>

Namespace: std

See Also

Concepts

<fstream> Members

basic_ofstream Members

basic_ostream Class

Thread Safety in the Standard C++ Library

iostream Programming

iostreams Conventions