_open, _wopen

Apre un file. Queste funzioni sono deprecate perché sono disponibili versioni più sicure. Vedere _sopen_s, _wsopen_s.

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

Parametri

• filename
  Nome file.

• oflag
  Tipo di operazioni consentite.

• pmode
  Modalità di autorizzazione.

Valore restituito

Ognuna di queste funzioni restituisce un descrittore di file per il file aperto. Un valore restituito di -1 indica un errore, nel qual caso errno viene impostato su uno dei valori seguenti.

• EACCES
  Si è tentato di aprire un file di sola lettura per la scrittura, la modalità di condivisione del file non consente le operazioni specificate o il percorso specificato è una directory.

• EEXIST
  Sono stati specificati i flag _O_CREAT e _O_EXCL, ma filename esiste già.

• EINVAL
  L'argomento oflag o pmode non è valido.

• EMFILE
  Non sono disponibili altri descrittori di file (sono aperti troppi file).

• ENOENT
  File o percorso non trovato.

Per altre informazioni su questi e altri codici restituiti, vedere errno, _doserrno, _sys_errlist, and _sys_nerr.

Note

La funzione _open apre il file specificato da filename e prepara il file per la lettura o la scrittura, come specificato da oflag. _wopen è una versione a caratteri wide di _open; l'argomento filename in _wopen è una stringa di caratteri wide. In caso contrario, _wopen e _open si comportano in modo identico.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definiti	_MBCS definito	_UNICODE definito
_topen	_open	_open	_wopen

oflag è un'espressione di valori integer costituita da una o più delle costanti del manifesto seguenti o combinazioni di costanti, definite in <fcntl.h>.

• _O_APPEND
  Sposta il puntatore a file alla fine del file prima di ogni operazione di scrittura.

• _O_BINARY
  Apre il file in modalità binaria (non convertita). Vedere fopen per una descrizione della modalità binaria.

• _O_CREAT
  Crea e apre un nuovo file per la scrittura. Non ha effetto se il file specificato da filename esiste. L'argomento pmode è obbligatorio quando è specificato _O_CREAT.

• _O_CREAT | _O_SHORT_LIVED
  Crea un file come temporaneo e se possibile non lo scarica su disco. L'argomento pmode è obbligatorio quando è specificato _O_CREAT.

• _O_CREAT | _O_TEMPORARY
  Crea un file come temporaneo; il file viene eliminato quando l'ultimo descrittore del file viene chiuso. L'argomento pmode è obbligatorio quando è specificato _O_CREAT.

• _O_CREAT | _O_EXCL
  Restituisce un errore se il file specificato da filename esiste. Si applica solo se usato con _O_CREAT.

• _O_NOINHERIT
  Impedisce la creazione di un descrittore di file condiviso.

• _O_RANDOM
  Specifica che la memorizzazione nella cache è ottimizzata, ma non limitata, per l'accesso casuale dal disco.

• _O_RDONLY
  Apre un file per la sola lettura. Non può essere specificato con _O_RDWR o _O_WRONLY.

• _O_RDWR
  Apre il file per lettura e scrittura. Non può essere specificato con _O_RDONLY o _O_WRONLY.

• _O_SEQUENTIAL
  Specifica che la memorizzazione nella cache è ottimizzata, ma non limitata, per l'accesso sequenziale dal disco.

• _O_TEXT
  Apre un file in modalità testo (convertito). Per altre informazioni, vedere I/O file modalità testo e binaria e fopen.

• _O_TRUNC
  Apre un file e lo tronca a lunghezza zero; il file deve disporre dell'autorizzazione di scrittura. Non può essere specificato con _O_RDONLY. _O_TRUNC usato con _O_CREAT apre un file esistente o crea un nuovo file.

  Nota

  Il flag _O_TRUNC elimina in modo permanente il contenuto del file specificato.

• _O_WRONLY
  Apre il file per la sola scrittura. Non può essere specificato con _O_RDONLY o _O_RDWR.

• _O_U16TEXT
  Apre il file in modalità Unicode UTF-16.

• _O_U8TEXT
  Apre il file in modalità Unicode UTF-8.

• _O_WTEXT
  Apre il file in modalità Unicode.

Per specificare la modalità di accesso al file, è necessario specificare _O_RDONLY, _O_RDWR o _O_WRONLY. Non vi è alcun valore predefinito per la modalità d'accesso.

Se si usa _O_WTEXT per aprire un file per la lettura, _open legge la parte iniziale del file e verifica la presenza di un indicatore dell'ordine dei byte. Se l'indicatore è presente, il file viene considerato come un file UTF-8 o UTF-16LE, a seconda dell'indicatore dell'ordine dei byte. In caso contrario, il file viene considerato come ANSI. Quando un file viene aperto per la scrittura con _O_WTEXT, viene usato il formato UTF-16. Indipendentemente da qualsiasi impostazione precedente o indicatore di ordine dei byte, se si usa _O_U8TEXT, il file viene sempre aperto come UTF-8, mentre se si usa _O_U16TEXT, il file viene sempre aperto come UTF-16.

Quando un file viene aperto in modalità Unicode usando _O_WTEXT, _O_U8TEXT o _O_U16TEXT, le funzioni di input traducono i dati letti dal file in dati UTF-16 archiviati come tipo wchar_t. Le funzioni che scrivono in un file aperto in modalità Unicode prevedono buffer contenenti dati UTF-16 archiviati come tipo wchar_t. Se il file è codificato come UTF-8, i dati UTF-16 vengono tradotti in UTF-8 alla scrittura e il contenuto del file codificato in UTF-8 viene tradotto in UTF-16 alla lettura. Un tentativo di leggere o scrivere un numero dispari di byte in modalità Unicode causerà un errore di convalida del parametro. Per leggere o scrivere dati archiviati nel programma come UTF-8, usare una modalità file di testo o binaria al posto della modalità Unicode. Eventuali traduzioni della codifica vanno gestite dall'utente.

Se _open viene chiamato con _O_WRONLY|_O_APPEND (modalità di aggiunta) e _O_WTEXT, _O_U16TEXT o _O_U8TEXT, tenterà innanzitutto di aprire il file per la lettura e la scrittura, di leggere l'indicatore di ordine dei byte e quindi di riaprirlo per la sola scrittura. Se l'apertura del file per lettura e scrittura ha esito negativo, il file verrà aperto per la sola lettura e verrà usato il valore predefinito per l'impostazione della modalità Unicode.

Quando due o più costanti del manifesto vengono usate per costituire l'argomento oflag, vengono combinate con l'operatore OR bit per bit ( |). Per una discussione sulle modalità testo e binaria, vedere l'argomento relativo all'I/O di file in modalità testo e binaria.

L'argomento pmode è obbligatorio solo quando è specificato _O_CREAT. Se il file esiste già, pmode viene ignorato. In caso contrario, pmode specifica le impostazioni di autorizzazione del file, che vengono impostate quando il nuovo file viene chiuso la prima volta. _open applica la maschera corrente di autorizzazione file a pmode prima di impostare le autorizzazioni. Per altre informazioni, vedere _umask. pmode è un'espressione integer che contiene una o entrambe le costanti del manifesto seguenti, definite in <sys\stat.h>.

• _S_IREAD
  Solo lettura consentita.

• _S_IWRITE
  Scrittura consentita. (In effetti, consente la lettura e la scrittura)

• _S_IREAD | _S_IWRITE
  Lettura e scrittura consentite.

Quando vengono fornite entrambe le costanti, queste sono combinate con l'operatore OR bit per bit ( |). In Windows tutti i file solo leggibili. L'autorizzazione di sola scrittura non è disponibile. Di conseguenza, le modalità _S_IWRITE e _S_IREAD  | _S_IWRITE sono equivalenti.

Se viene specificato un valore diverso da una combinazione di _S_IREAD e _S_IWRITE per pmode, anche se viene specificato un elemento pmode valido in un altro sistema operativo, o se viene specificato un valore diverso dai valori oflag consentiti, la funzione genera un'asserzione in modalità debug e richiama il gestore dei parametri non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno su EINVAL.

Requisiti

Routine	Intestazione obbligatoria	Intestazione facoltativa
_open	<io.h>	<fcntl.h>, <sys\types.h>, <sys\stat.h>
_wopen	<io.h> o <wchar.h>	<fcntl.h>, <sys\types.h>, <sys\stat.h>

_open e _wopen sono estensioni Microsoft. Per altre informazioni sulla compatibilità, vedere Compatibilità.

Librerie

Tutte le versioni delle librerie di runtime C.

Esempio

// 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

Equivalente .NET Framework

• System::IO::File::Open

• System::IO::FileStream::FileStream

Vedere anche

Riferimenti

I/O a basso livello

_chmod, _wchmod

_close

_creat, _wcreat

_dup, _dup2

fopen, _wfopen

_sopen, _wsopen