basic_filebuf::open

Öffnet eine Datei.

basic_filebuf<Elem, Tr> *open(
    const char *_Filename,
    ios_base::openmode _Mode,
    int _Prot = (int)ios_base::_Openprot
);
basic_filebuf<Elem, Tr> *open(
    const char *_Filename,
    ios_base::openmode _Mode
);
basic_filebuf<Elem, Tr> *open(
    const wchar_t *_Filename,
    ios_base::openmode _Mode,
    int _Prot = (int)ios_base::_Openprot
);
basic_filebuf<Elem, Tr> *open(
    const wchar_t *_Filename,
    ios_base::openmode _Mode
);

Parameter

  • _Filename
    Der Name der Datei selbst zu öffnen.

  • _Mode
    Eine der Enumerationen in ios_base::openmode.

  • _Prot
    Der Standarddateiöffnungsschutz, Entsprechung zum shflag-Parameter in _fsopen, _wfsopen.

Rückgabewert

Wenn der Dateizeiger ein NULL-Zeiger ist, gibt die Funktion einen NULL-Zeiger zurück.Andernfalls gibt sie this zurück.

Hinweise

Die Memberfunktion öffnet die Datei mit Dateinamendateinamen, indem sie fopen(Dateinamen, strmode) aufgerufen wird.strmode wird von mode & bestimmt | (ase &. | Binärdatei):

  • ios_base::in wird "r" (geöffnete vorhandene Datei zum Lesen).

  • ios_base::out oder ios_base::out | ios_base::trunc wird "w" (schneiden Sie vorhandene Datei ab oder erstellen Sie zum Schreiben).

  • ios_base::out | app wird "a" (geöffnete vorhandene Datei an alle schreibt).

  • ios_base::in | ios_base::out wird "r+" (geöffnete vorhandene Datei zum Lesen und Schreiben).

  • ios_base::in | ios_base::out | ios_base::trunc wird "w+" (schneiden Sie vorhandene Datei ab oder erstellen Sie für das Lesen und Schreiben).

  • ios_base::in | ios_base::out | ios_base::app wird "a+" (geöffnete vorhandene Datei zum Lesen und zum Anfügen alle schreibt).

Wenn mode & ios_base::binary ungleich 0 ist, fügt die Funktion b zu strmode an, um einen Binärstream anstelle eines Textstreams zu öffnen.Er speichert den Wert, der von fopen im Dateizeiger fp zurückgegeben wird.Wenn mode & ios_base::ate ungleich 0 ist und der Dateizeiger kein NULL-Zeiger ist, die Funktionsaufrufe fseek(fp, 0, SEEK_END) der Streams am Dateiende zu positionieren.Wenn dieser Positionierungseigenschaft Vorgang fehlschlägt, die Funktionsaufrufe Abschluss(fp) und speichert ein NULL-Zeiger im Dateizeiger.

Wenn der Dateizeiger kein NULL-Zeiger ist, bestimmt die - Funktion das Dateikonvertierungsfacet: use_facet<codecvt<Elem, char, traits_type::state_type> > (getloc), für Unterlauf und Überlauf.

Wenn der Dateizeiger ein NULL-Zeiger ist, gibt die Funktion einen NULL-Zeiger zurück.Andernfalls gibt sie this zurück.

Beispiel

Siehe basic_filebuf::close als ein Beispiel, das open verwendet.

Anforderungen

Header: <fstream>

Namespace: std

Siehe auch

Referenz

basic_filebuf Class

Programmierung der iostream-Headerdatei

iostreams Konventionen