std::basic_fstream<CharT,Traits>:: open
|
void
open
(
const
char
*
Dateiname,
std::
ios_base
::
openmode
Modus
|
(1) | |
|
void
open
(
const
std
::
filesystem
::
path
::
value_type
*
Dateiname,
std::
ios_base
::
openmode
Modus
|
(2) | (seit C++17) |
|
void
open
(
const
std::
string
&
Dateiname,
std::
ios_base
::
openmode
Modus
|
(3) | (seit C++11) |
|
void
open
(
const
std::
filesystem
::
path
&
Dateiname,
std::
ios_base
::
openmode
Modus
|
(4) | (seit C++17) |
Öffnet und verknüpft die Datei mit dem Namen filename mit dem Dateistrom.
Ruft bei Erfolg clear ( ) auf. Ruft bei Fehler setstate ( failbit ) auf.
std::filesystem::path::value_type
nicht
char
ist.
(seit C++17)
Inhaltsverzeichnis |
Parameter
| filename | - | der Name der zu öffnenden Datei | ||||||||||||||||
| mode | - |
gibt den Öffnungsmodus des Streams an. Es handelt sich um einen
BitmaskType
, die folgenden Konstanten sind definiert:
|
Beispiel
#include <fstream> #include <iostream> #include <string> int main() { std::string filename = "example.123"; std::fstream fs; fs.open(filename); if (!fs.is_open()) { fs.clear(); fs.open(filename, std::ios::out); // create file fs.close(); fs.open(filename); } std::cout << std::boolalpha; std::cout << "fs.is_open() = " << fs.is_open() << '\n'; std::cout << "fs.good() = " << fs.good() << '\n'; }
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrektes Verhalten |
|---|---|---|---|
| LWG 22 | C++98 | Es war unklar, wie sich der Fehlerzustand bei erfolgreichem Öffnen ändert | Der Fehlerzustand bleibt unverändert |
| LWG 409 | C++98 | Der Fehlerzustand blieb bei erfolgreichem Öffnen unverändert | Er wird gelöscht [1] |
| LWG 460 | C++98 |
Das Standardargument von
mode
in Überladung
(1)
fehlte (es ist in der Synopsis vorhanden) |
Hinzugefügt |
- ↑ Die Resolution des LWG Issues #22 wird überschrieben.
Siehe auch
|
prüft, ob der Stream eine zugeordnete Datei hat
(öffentliche Elementfunktion) |
|
|
schließt die zugeordnete Datei
(öffentliche Elementfunktion) |
|
|
öffnet eine Datei und konfiguriert sie als zugeordnete Zeichensequenz
(öffentliche Elementfunktion von
std::basic_filebuf<CharT,Traits>
)
|