basic_ofstream::basic_ofstream

Artikel
06/09/2015

Erstellt ein Objekt vom Typ basic_ofstream.

basic_ofstream( );
explicit basic_ofstream(
    const char *_Filename,
    ios_base::openmode _Mode = ios_base::out,
    int _Prot = (int)ios_base::_Openprot
);
explicit basic_ofstream(
    const wchar_t *_Filename,
    ios_base::openmode _Mode = ios_base::out,
    int _Prot = (int)ios_base::_Openprot
);
basic_ofstream(
    basic_ofstream&& _Right
);

Parameter

_Filename
Der Name der Datei zum Öffnen.
_Mode
Eine der Enumerationen in ios_base::openmode.
_Prot
Der Standarddateiöffnungsschutz, Entsprechung zum Parameter shflag in _fsopen, _wfsopen.
_Right
Der rvalu-Verweis zum basic_ofstream-Objekt, das verwendet wird, um diese basic_ofstream-Objekt initialisieren.

Hinweise

Der erste Konstruktor initialisiert die Basisklasse, indem er die basic_ostream(sb) aufrufen, wobei das sb gespeicherte Objekt der Klasse basic_filebuf<Elem, Tr>ist. Es initialisiert auch sb, indem basic_filebuf<Elem, Tr>aufruft.

Im zweiten und dritten Konstruktoren initialisiert die Basisklasse, indem basic_ostream(sb) aufrufen. Es initialisiert auch sb, indem basic_filebuf<Elem, Tr> und dann sb aufruft.open(_Filename, _Mode | ios_base::out). Wenn die letzte Funktion einem NULL-Zeiger zurückgibt, ruft der Konstruktor auf setstate(failbit).

Der vierte Konstruktor ist eine Kopierfunktion. Er initialisiert das Objekt mit dem Inhalt von right, wird als rvalu-Verweis.

Beispiel

Das folgende Beispiel zeigt, wie ein basic_ofstream-Objekt erstellt und in diese schreibt.

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

using namespace std;

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