_fsopen, _wfsopen

Ein Stream mit Dateifreigabe öffnen

Syntax

FILE *_fsopen(
   const char *filename,
   const char *mode,
   int shflag
);
FILE *_wfsopen(
   const wchar_t *filename,
   const wchar_t *mode,
   int shflag
);

Parameter

filename
Name der zu öffnenden Datei.

mode
Zugriffstyp zulässig.

shflag
Freigabetyp erlaubt.

Rückgabewert

Jede dieser Funktionen gibt einen Zeiger auf den Stream zurück. Ein NULL-Zeigerwert gibt einen Fehler an. Wenn filename oder eine leere Zeichenfolge istNULL, mode rufen diese Funktionen den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen NULL zurück und stellen errno auf EINVAL ein.

Weitere Informationen zu diesen und anderen Fehlercodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die Funktion _fsopen öffnet die durch filename als Stream angegebene Datei und bereitet sie zur Lese- oder Schreibfreigabe vor, wie durch Modus und shflag Argumente definiert. _wfsopen ist eine Breitzeichenversion von _fsopen. Die filename und mode Argumente für _wfsopen sind Zeichenfolgen mit Breitzeichen. _wfsopen und _fsopen verhalten sich andernfalls identisch.

Die Zeichenfolge mode gibt den Typ des Zugriffs, der für die Datei angefordert wird, wie in der folgenden Tabelle gezeigt, an.

Verwenden Sie die Typen "w" und "w+" mit Bedacht, da sie vorhandene Dateien zerstören können.

Wenn eine Datei mit dem Zugriffstyp "a" oder "a+" geöffnet wird, treten alle Schreibvorgänge am Ende der Datei auf. Der Dateizeiger kann mithilfe fseek oder rewindverschoben werden, wird jedoch immer wieder an das Ende der Datei verschoben, bevor ein Schreibvorgang ausgeführt wird. Daher können vorhandene Daten nicht überschrieben werden. Wenn der Zugriffstyp "r+", "w+" oder "a+" angegeben ist, sind sowohl Lese- als auch Schreibzugriff zulässig (die Datei wird für die Aktualisierung geöffnet). Beim Wechseln zwischen Lese- und Schreibvorgängen muss es jedoch einen dazwischen liegenden fsetpos, fseekoder rewind einen Vorgang geben. Bei Bedarf kann die aktuelle Position für den Vorgang fsetpos oder fseek angegeben werden. Zusätzlich zu den oben aufgeführten Werten kann eines der folgenden Zeichen in mode enthalten sein, um den Übersetzungsmodus für neue Zeilen anzugeben und für Dateiverwaltung.

Wenn t oder b nicht angegeben modewird, wird der Übersetzungsmodus durch die Standardmodusvariable _fmodedefiniert. Wenn dem Argument t oder b vorangestellt wird, schlägt die Funktion fehl und gibt NULLzurück. Eine Erläuterung der Text- und Binärmodi finden Sie unter "Text- und Binärmodusdatei-E/A".

Bezüglich T und D:

• T verhindert, dass die Datei auf den Datenträger geschrieben wird, solange kein Arbeitsspeicherdruck erforderlich ist. Weitere Informationen finden Sie in FILE_ATTRIBUTE_TEMPORARY Datei-Attributkonstanten und auch in diesem Blogbeitrag Es ist nur temporär.
• D Gibt eine normale Datei an, die auf den Datenträger geschrieben wird. Der Unterschied besteht darin, dass sie beim Schließen automatisch gelöscht wird. Sie können kombinieren TD , um beide Semantik abzurufen.

_fsopen und _wfsopen sind microsoftspezifische Varianten von fopen. Sie sind nicht Teil des ANSI-Standards. Für eine tragbarere und sicherere Funktion, wenn Sie keine Dateifreigabe benötigen, erwägen _wfopen_s oder fopen_s.

Das Argument shflag ist ein konstanter Ausdruck, der aus einer der folgenden Manifestkonstanten besteht, die in Share.h.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Anforderungen

Beispiel

// crt_fsopen.c

#include <stdio.h>
#include <stdlib.h>
#include <share.h>

int main( void )
{
   FILE *stream;

   // Open output file for writing. Using _fsopen allows us to
   // ensure that no one else writes to the file while we are
   // writing to it.
    //
   if( (stream = _fsopen( "outfile", "wt", _SH_DENYWR )) != NULL )
   {
      fprintf( stream, "No one else in the network can write "
                       "to this file until we are done.\n" );
      fclose( stream );
   }
   // Now others can write to the file while we read it.
   system( "type outfile" );
}

No one else in the network can write to this file until we are done.

Siehe auch

Stream-E/A
fclose, _fcloseall
_fdopen, _wfdopen
ferror
_fileno
fopen, _wfopen
freopen, _wfreopen
_open, _wopen
_setmode
_sopen, _wsopen