_fsopen, _wfsopen

Apre un flusso alla condivisione di file.

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

Parametri

• filename
  Nome del file da aprire.

• mode
  Tipo di valido di accesso.

• shflag
  Tipo di condividere consentito.

Valore restituito

Ognuna di queste funzioni restituisce un puntatore al flusso.un valore di puntatore null indica un errore.Se filename o mode è NULL o una stringa vuota, queste funzioni richiamare il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni NULL di ritorno e errno stabilito a EINVAL.

Per ulteriori informazioni su questi e altri codici di errore, vedere _doserrno, errno, _sys_errlist e _sys_nerr.

Note

La funzione di _fsopen apre il file specificato da filename come flusso e prepara il file per lettura condivisa successiva o scrittura, come definito dalla modalità e dagli argomenti di shflag ._wfsopen è una versione a caratteri estesi di _fsopen; gli argomenti di mode e di filename a _wfsopen sono stringhe di caratteri estesi._wfsopen e _fsopen si comportano in modo identico in caso contrario.

La stringa di caratteri mode specifica il tipo di accesso richiesta di file, come illustrato nella tabella seguente.

Utilizzare con attenzione i tipi di "w+" e di "w" , ad esempio possono eliminare i file esistenti.

Quando un file viene aperto con il tipo di accesso di "a+" o di "a" , tutte le operazioni di scrittura si verificano alla fine del file.Il puntatore del file può essere riposizionato utilizzando fseek o di rewind, ma viene spostato sempre alla fine del file prima che qualsiasi operazione di scrittura sia eseguita.Pertanto, i dati esistenti non possono essere sovrascritti.Quando "r+", "w+", o il tipo di accesso di "a+" viene specificato, sia la lettura e la scrittura sono consentite (il file viene aperto per l'aggiornamento).Quando tuttavia si passano tra la lettura e la scrittura, deve essere fsetposcorrispondente, fseek, o operazione di rewind .La posizione corrente può essere specificata per l'operazione di fseek o di fsetpos , se desiderata.Oltre ai valori in precedenza, uno dei seguenti caratteri può essere incluso in mode per specificare la modalità di traduzione per le nuove righe e per la gestione dei file.

Se t o b non è modefornito in, la modalità di conversione definita dalla variabile _fmodedi impostazione predefinita-modalità.Se t o b è preceduta l ' argomento, la funzione ha esito negativo e restituisce NULL.Per informazioni sulle modalità del binario e del testo, vedere La modalità del binario di testo e archivia I/O.

L'argomento shflag è un'espressione costante la quantità delle costanti manifesto, definito in Share.h.

Mapping di routine a testo generico

Requisiti

Esempio

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

Equivalente .NET Framework

• System:: I:: file:: Aprire

• System:: I:: FILESTREAM:: FILESTREAM

Vedere anche

Riferimenti

Flusso I/O

fclose, _fcloseall

_fdopen, _wfdopen

ferror

_fileno

fopen, _wfopen

freopen, _wfreopen

_open, _wopen

_setmode

_sopen, _wsopen