_open, _wopen

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

Sintassi

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

Parametri

filename
Nome del 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.

Valore errno Condizione
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_errliste _sys_nerr.

Osservazioni:

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

<tchar.h> Routine _UNICODE e _MBCS non definito _MBCS Definito _UNICODE Definito
_topen _open _open _wopen

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

oflag Costante Comportamento
_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). Per una descrizione della modalità binaria, vedere fopen .
_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 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. Per mantenere il comportamento legacy per la compatibilità delle app, gli altri processi non impediscono l'eliminazione di questo file.
_O_CREAT | _O_EXCL Restituisce un errore se un 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 è possibile specificare con _O_RDWR o _O_WRONLY.
_O_RDWR Apre un file per lettura e scrittura. Non è possibile specificare 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 del file in modalità testo e binario e fopen.)
_O_TRUNC Apre un file e lo tronca a lunghezza zero; il file deve disporre dell'autorizzazione di scrittura. Non è possibile specificare con _O_RDONLY. _O_TRUNC usato con _O_CREAT apre un file esistente o crea un nuovo file. Nota: il _O_TRUNC flag elimina definitivamente il contenuto del file specificato.
_O_WRONLY Apre un file per la sola scrittura. Non è possibile specificare con _O_RDONLY o _O_RDWR.
_O_U16TEXT Apre un file in modalità Unicode UTF-16.
_O_U8TEXT Apre un file in modalità Unicode UTF-8.
_O_WTEXT Apre un file in modalità Unicode.

Per specificare la modalità di accesso al file, è necessario specificare _O_RDONLY, _O_RDWR o _O_WRONLY. Non esiste alcun valore predefinito per la modalità di 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 è presente un BOM, il file viene considerato come UTF-8 o UTF-16LE, a seconda della distinta base. 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 viene codificato come UTF-8, i dati UTF-16 vengono convertiti in UTF-8 quando vengono scritti. Il contenuto con codifica UTF-8 del file viene convertito in UTF-16 quando viene letto. Un tentativo di lettura o scrittura di 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. L'utente è responsabile di qualsiasi traduzione di codifica necessaria.

Se _open viene chiamato con _O_WRONLY | _O_APPEND (modalità di aggiunta) e _O_WTEXT, _O_U16TEXT o _O_U8TEXT, tenterà prima di tutti 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 vengono usate due o più costanti manifeste per comporre l'argomento oflag, le costanti vengono combinate con l'operatore OR bit per bit ( | ). Per una descrizione delle modalità binarie e di testo, vedere 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 manifesto seguenti, definite in <sys\stat.h>.

pmode Significato
_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, vengono unite con l'operatore OR bit per bit ( | ). In Windows tutti i file sono leggibili; l'autorizzazione di sola scrittura non è disponibile. Di conseguenza, le modalità _S_IWRITE e _S_IREAD | _S_IWRITE sono equivalenti.

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

Requisiti

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

_open e _wopen sono estensioni Microsoft. Per altre informazioni sulla compatibilità, vedere Compatibility (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

Vedi anche

I/O di basso livello
_chmod, _wchmod
_close
_creat, _wcreat
_dup, _dup2
fopen, _wfopen
_sopen, _wsopen