_open, _wopen

Öffnet eine Datei. Diese Funktionen sind veraltet, da sicherere Versionen verfügbar sind; siehe _sopen_s, _wsopen_s.

Syntax

int _open(
   const char *filename,
   int oflag [,
   int pmode]
);
int _wopen(
   const wchar_t *filename,
   int oflag [,
   int pmode]
);

Parameter

filename
Dateiname.

oflag
Die zulässige Art von Vorgängen.

pmode
Berechtigungsmodus.

Rückgabewert

Jede dieser Funktionen gibt einen Dateideskriptor für die geöffnete Datei zurück. Der Rückgabewert -1 weist auf einen Fehler hin. In diesem Fall wird errno auf einen der folgenden Werte festgelegt.

Weitere Informationen zu diesen und anderen Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die Funktion _open öffnet die von filename angegebene Datei und bereitet sie für das Lesen oder Schreiben vor, wie von oflag angegeben. _wopen ist eine Breitzeichenversion von _open. Das filename -Argument für _wopen ist eine Breitzeichenfolge. _wopen und _open verhalten sich andernfalls identisch.

Mapping generischer Textroutinen

oflag ist ein ganzzahliger Ausdruck, der aus einer oder mehreren der folgenden Manifestkonstanten oder Konstantenkombinationen gebildet wird, die in <fcntl.h>definiert sind.

Zum Angeben des Dateizugriffsmodus müssen Sie _O_RDONLY, _O_RDWR oder _O_WRONLY angeben. Für den Zugriffsmodus gibt es keinen Standardwert.

Wenn _O_WTEXT verwendet wird, um eine Datei zum Lesen zu öffnen, liest _open den Anfang der Datei und überprüft sie auf eine Bytereihenfolgemarkierung (BOM). Wenn eine BOM vorhanden ist, wird die Datei je nach BOM als UTF-8 oder UTF-16LE behandelt. Wenn keine BOM vorhanden ist, wird die Datei als ANSI behandelt. Wenn eine Datei mit _O_WTEXT zum Schreiben geöffnet wird, wird UTF-16 verwendet. Unabhängig von früheren Einstellungen oder Bytereihenfolgemarkierungen wird die Datei bei Verwendung von _O_U8TEXT immer als UTF-8 geöffnet. Wenn _O_U16TEXT verwendet wird, wird die Datei immer als UTF-16 geöffnet.

Wenn eine Datei mit _O_WTEXT, _O_U8TEXT oder _O_U16TEXT im Unicode-Modus geöffnet wird, übersetzen die Eingabefunktionen die aus der Datei gelesenen Daten in UTF-16-Daten, die als Datentyp wchar_t gespeichert werden. Funktionen, die in eine im Unicode-Modus geöffnete Datei schreiben, erwarten Puffer, die UTF-16-Daten, die als Datentyp wchar_tgespeichert sind. Wenn die Datei als UTF-8 codiert ist, werden UTF-16-Daten beim Schreiben in UTF-8 übersetzt. Der UTF-8-codierte Inhalt der Datei wird beim Lesen in UTF-16 übersetzt. Der Versuch, eine ungerade Anzahl von Bytes im Unicode-Modus zu lesen oder zu schreiben, führt zu einem Parametervalidierungsfehler . Wenn Sie Daten lesen oder schreiben möchten, die in Ihrem Programm als UTF-8 gespeichert sind, verwenden Sie den Text- oder Binärdateienmodus anstelle eines Unicode-Modus. Sie sind für alle erforderlichen Codierungsübersetzungen verantwortlich.

Wenn _open mit _O_WRONLY | _O_APPEND (Anfügemodus) und _O_WTEXT,_O_U16TEXT oder _O_U8TEXT aufgerufen wird, versucht sie zuerst, die Datei zum Lesen und Schreiben zu öffnen, und dann, die BOM zu lesen und die Datei erneut, jedoch nur zum Schreiben, zu öffnen. Wenn das Öffnen der Datei zum Lesen und Schreiben fehlschlägt, wird die Datei nur zum Schreiben geöffnet und der Standardwert für die Unicode-Moduseinstellung verwendet.

Wenn zwei oder mehr Manifestkonstanten verwendet werden, um das oflag-Argument zu bilden, werden die Konstanten mit dem bitweisen OR-Operator kombiniert ( | ). Eine Erläuterung der Binär- und Textmodi finden Sie unter "Text- und Binärmodusdatei-E/A".

Das Argument pmode ist nur erforderlich, wenn _O_CREAT angegeben wird. Wenn die Datei bereits vorhanden ist, wird pmode ignoriert. Andernfalls gibt pmode die Dateiberechtigungseinstellungen an, die festgelegt werden, wenn die neue Datei zum ersten Mal geschlossen wird. _open wendet die aktuelle Dateiberechtigungsmaske für pmode an, bevor die Berechtigungen festgelegt werden. (Weitere Informationen finden Sie unter _umask.) pmode ist ein ganzzahliger Ausdruck, der eine oder beide der folgenden Manifestkonstanten enthält, die in <sys\stat.h>definiert sind.

Wenn beide Konstanten angegeben werden, werden sie mit dem bitweisen OR-Operator ( | ) verknüpft. In Windows sind alle Dateien lesbar; Schreibgeschützte Berechtigung ist nicht verfügbar. Deshalb sind die Modi _S_IWRITE und _S_IREAD | _S_IWRITE gleichwertig.

Wenn ein anderer Wert als eine andere Kombination von _S_IREAD und _S_IWRITE wird angegeben für pmode– auch wenn er einen gültigen pmode in einem anderen Betriebssystem angeben würde - oder wenn ein anderer Wert als die zulässigen oflag Werte angegeben wird, generiert die Funktion eine Assertion im Debugmodus und ruft den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt die Funktion -1 zurück und stellt errno auf EINVALein.

Anforderungen

_open und _wopen sind Microsoft-Erweiterungen. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Libraries

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

// crt_open.c
// compile with: /W3
/* This program uses _open to open a file
* named CRT_OPEN.C for input and a file named CRT_OPEN.OUT
* for output. The files are then closed.
*/
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <io.h>
#include <stdio.h>

int main( void )
{
   int fh1, fh2;

   fh1 = _open( "CRT_OPEN.C", _O_RDONLY ); // C4996
   // Note: _open is deprecated; consider using _sopen_s instead
   if( fh1 == -1 )
      perror( "Open failed on input file" );
   else
   {
      printf( "Open succeeded on input file\n" );
      _close( fh1 );
   }

   fh2 = _open( "CRT_OPEN.OUT",
                _O_WRONLY | _O_CREAT,
                _S_IREAD | _S_IWRITE ); // C4996
   if( fh2 == -1 )
      perror( "Open failed on output file" );
   else
   {
      printf( "Open succeeded on output file\n" );
      _close( fh2 );
   }
}

Output

Open succeeded on input file
Open succeeded on output file

Siehe auch

E/A auf niedriger Ebene
_chmod, _wchmod
_close
_creat, _wcreat
_dup, _dup2
fopen, _wfopen
_sopen, _wsopen