_fsopen, _wfsopen

Öffnet einen Stream mit den Datenzugriff.

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

Parameter

• filename
  Der Name der zu öffnenden Datei.

• mode
  Art des Zugriffs zulässig.

• shflag
  Der Typ der Freigabe zulässig.

Rückgabewert

Jede dieser Funktionen gibt einen Zeiger auf den Stream zurück.Ein NULL-Zeiger-Wert gibt einen Fehler an.Wenn filename oder modeNULL oder eine leere Zeichenfolge ist, rufen diese Funktionen der ungültige Parameter für ein, z. B. in beschrieben Parametervalidierung.Wenn die Ausführung fortgesetzt werden kann, darf dieser Funktionen geben NULL festlegen und errno zu EINVAL.

Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Die _fsopen Funktion öffnet die Datei, die von filename als Stream angegeben ist und bereitet die Datei für folgende freigegebene Lesen oder Schreiben vor, wie vom Modus und die shflag Argumenten definiert._wfsopen ist eine Breitzeichen-Version von _fsopen. mode Argumente an die filename und _wfsopen sind Zeichenfolgen mit Breitzeichen._wfsopen und _fsopen verhalten sich ansonsten unterscheiden.

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

Verwenden Sie die "w" und "w+" Typen sorgfältig, deren vorhandene Dateien löschen können.

Wenn eine Datei mit dem "a" oder "a+" Zugriffstyp geöffnet wird, werden alle Schreibvorgänge am Ende der Datei auf.Der Dateizeiger kann mithilfe fseek oder rewindneu angeordnet werden jedoch immer wieder an das Ende der Datei verschoben werden, bevor jeder Schreibvorgang ausgeführt wird.Daher können vorhandene Daten nicht überschrieben werden.Wenn "r+", Zugriffstyp, oder "w+""a+" angegeben ist, wird das Lesen und Schreiben zulässt (die Datei soll nach Updates geöffnet).Beim jedoch zwischen Lese- und Schreibvorgänge wechseln, muss es intervenierendes fsetpos, fseekoder Rückspulen Vorgang sein.Die aktuelle Position kann für den fsetpos oder fseek Vorgang angegeben werden, wenn dies erforderlich ist.Neben den oben beschriebenen Werten kann eines der folgenden Zeichen in mode eingeschlossen werden, um den Modus für Übersetzungs für neue Zeilen und Dateiverwaltung anzugeben.

Wenn t oder b nicht in modeangegeben ist, wird der Modus Übersetzungs von der DEFAULT Modus Variable _fmodedefiniert.Wenn t oder b auf das Argument vorangestellt wird, bewirkt, dass die Funktion NULLund gibt diese zurück.Eine Erörterung Text- und binäre Daten ändert, finden Sie unter Text und Binärdatei-Modus-Datei E/A.

Das Argument shflag ist ein konstanter Ausdruck das Bestehen der folgenden Manifesten Konstanten, definiert in Share.h.

Zuweisung 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" );
}

.NET Framework-Entsprechung

• System:: EA:: Datei:: Öffnen

• System:: EA:: FileStream:: FileStream

Siehe auch

Referenz

Stream E/A

fclose, _fcloseall

_fdopen, _wfdopen

ferror

_fileno

fopen, _wfopen

freopen, _wfreopen

_open, _wopen

_setmode

_sopen, _wsopen