Freigeben über


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 zum Öffnen.

  • _Mode
    Eine der Enumerationen in ios_base::openmode.

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

Rückgabewert

Wenn der Dateizeiger ein NULL-Zeiger wird, gibt die Funktion einem NULL-Zeiger zurück. Andernfalls gibt diese this zurück.

Hinweise

Die Memberfunktion wird die Datei mit Dateinamendateinamen, indem sie fopen(Dateinamen, strmode) aufruft. strmode wird von Modus & bestimmt | (& | Binärdatei):

  • ios_base::in"r" wird (offene 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 | Anwendung"a" wird (offene vorhandene Datei zum Anfügen alle schreibt).

  • ios_base::in | ios_base::out"r+" wird (offene vorhandene Datei für Lese- und Schreibvorgänge).

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

  • ios_base::in | ios_base::out | ios_base::app"a+" wird (offene vorhandene Datei für das Lesen und zum Anfügen alle schreibt).

Wenn mode & ios_base::binary nicht 0 ist, wird die b zu strmode an, um einen Binärstream anstelle eines Textstreams zu öffnen. Er speichert den Wert, der durch fopen im Dateizeiger fp zurückgegeben wird. Wenn mode & ios_base::ate nicht 0 ist und der Dateizeiger kein NULL-Zeiger ist, die Funktionsaufrufe fseek(fp, 0, SEEK_END) z des Streams am Dateiende zu positionieren. Wenn dieser Positionierungseigenschaft Vorgang fehlschlägt, die Funktion schließen(fp) und Speicher 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 wird, gibt die Funktion einem NULL-Zeiger zurück. Andernfalls gibt diese this zurück.

Beispiel

Ein Beispiel finden Sie unter basic_filebuf::close, das open verwendet.

Anforderungen

Header: <fstream>

Namespace: std

Siehe auch

Referenz

basic_filebuf-Klasse

iostream-Programmierung

iostreams-Konventionen