Namensräume
Varianten
Aktionen

std::basic_ofstream<CharT,Traits>::open

Von cppreference.com
< cpp‎ | io‎ | basic_ofstream
 
 
 
 
void open( const char* filename,

           std::ios_base::openmode mode

               = std::ios_base::out);
(1)
void open( const char* filename,

           std::ios_base::openmode mode

               = std::ios_base::out);
(2) (seit C++17)
void open( const std::string& filename,

           std::ios_base::openmode mode

               = std::ios_base::out);
(3) (seit C++11)
void open( const std::filesystem::path& filename,

           std::ios_base::openmode mode

               = std::ios_base::out);
(4) (seit C++17)

Öffnet die Datei mit dem Namen filename und verknüpft sie mit dem Dateistrom.

Ruft clear() im Erfolgsfall auf. Ruft setstate(failbit) im Fehlerfall auf.

1,2) Ruft effektiv auf rdbuf()->open(filename, mode | ios_base::out) auf (Details zu den Auswirkungen dieses Aufrufs siehe std::basic_filebuf::open). Überladung (2) ist nur dann bereitgestellt, wenn std::filesystem::path::value_type nicht char ist.(seit C++17)
3,4) Ruft effektiv (1,2) auf, als ob open(filename.c_str(), mode) aufgerufen worden wäre.

Inhalt

[bearbeiten] Parameter

filename - der Name der zu öffnenden Datei
mode - gibt den Öffnungsmodus des Streams an. Es ist ein BitmaskType, die folgenden Konstanten sind definiert
Konstante Erklärung
app an das Ende des Streams vor jedem Schreibvorgang positionieren
binary im Binärmodus öffnen
in zum Lesen öffnen
out zum Schreiben öffnen
trunc den Inhalt des Streams beim Öffnen verwerfen
ate unmittelbar nach dem Öffnen an das Ende des Streams positionieren
noreplace (C++23) im exklusiven Modus öffnen

[bearbeiten] Rückgabewert

(keine)

[bearbeiten] Beispiel

[bearbeiten] Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 22 C++98 Es war unklar, wie sich der Fehlerstatus nach einer erfolgreichen Öffnung ändert Der Fehlerstatus bleibt unverändert
LWG 409 C++98 Der Fehlerstatus änderte sich bei einer erfolgreichen Öffnung nicht Er wird gelöscht[1]
  1. Die Auflösung von LWG-Problem #22 wird überschrieben.

[bearbeiten] Siehe auch

prüft, ob der Stream eine zugeordnete Datei hat
(public member function) [edit]
schließt die zugeordnete Datei
(public member function) [edit]
öffnet eine Datei und konfiguriert sie als zugeordnete Zeichensequenz
(public member function of std::basic_filebuf<CharT,Traits>) [bearbeiten]