Condividi tramite


I/O di flusso

Queste funzioni elaborano dati di diverse dimensioni e formati, da singoli caratteri a strutture dati di grandi dimensioni. Forniscono anche il buffering, migliorando le prestazioni. Le dimensioni predefinite del buffer del flusso sono 4 KB. Queste routine influiscono solo su buffer creati dalle routine di libreria di runtime e non hanno alcun effetto sui buffer creati dal sistema operativo.

Routine di I/O di flusso

Ciclo Utilizzo
clearerr, clearerr_s Eliminare l'indicatore di errore per il flusso
fclose Chiudere il flusso
_fcloseall Chiudere tutti i flussi aperti tranne stdin, stdoute stderr
_fdopen, wfdopen Associare il flusso a un descrittore di file del file aperto
feof Test per la fine del file sul flusso
ferror Test per l'errore sul flusso
fflush Svuotare il flusso dal buffer o dal dispositivo di archiviazione
fgetc, fgetwc Leggere caratteri dal flusso (versioni della funzione di getc e di getwc)
_fgetchar, _fgetwchar Leggere caratteri dal flusso stdin (versioni della funzione di getchar e di getwchar)
fgetpos Ottenere l'indicatore di posizione del flusso
fgets, fgetws Leggere una stringa dal flusso
_fileno Ottenere il descrittore di file associato al flusso
_flushall Svuotare tutti i flussi dal buffer o dal dispositivo di archiviazione
fopen, _wfopen, fopen_s_wfopen_s Aprire il flusso
fprintf, _fprintf_l, fwprintf, _fwprintf_lfprintf_s, _fprintf_s_l, , fwprintf_s_fwprintf_s_l Scrivere dati formattati in un flusso
fputc, fputwc Scrivere un carattere in un flusso (versioni di funzione di putc e di putwc)
_fputchar, _fputwchar Scrivere il carattere su stdout (versioni di funzione di putchar e di putwchar)
fputs, fputws Scrivere una stringa nel flusso
fread Leggere dati non formattati da un flusso
freopen, _wfreopen, freopen_s_wfreopen_s Riposizionare il puntatore del flusso FILE in un nuovo file o dispositivo
fscanf, fwscanf, fscanf_s, _fscanf_s_l, fwscanf_s_fwscanf_s_l Leggere dati formattati da un flusso
fseek, _fseeki64 Spostare la posizione del file nel percorso specificato
fsetpos Impostare l'indicatore di posizione del flusso
_fsopen, _wfsopen Aprire il flusso con condivisione di file
ftell, _ftelli64 Ottenere la posizione corrente del file
fwrite Scrivere gli elementi di dati non formattati nel flusso
getc, getwc Leggere i caratteri dal flusso (versioni macro di fgetc e di fgetwc)
getchar, getwchar Leggere i caratteri da stdin (versioni macro di fgetchar e di fgetwchar)
_getmaxstdio Restituisce il numero dei file aperti contemporaneamente consentito a livello di I/O del flusso.
gets_s, _getws_s Leggere una riga da stdin
_getw Leggere int binari da un flusso
printf, _printf_l, wprintf, _wprintf_l,printf_s_printf_s_l , , , wprintf_s_wprintf_s_l Scrivere dati formattati in stdout
putc, putwc Scrivere un carattere in un flusso (versioni macro di fputc e di fputwc)
putchar, putwchar Scrivere un carattere in stdout (versioni macro di fputchar e di fputwchar)
puts, _putws Scrivere una riga nel flusso
_putw Scrivere int binari in un flusso
rewind Spostare la posizione del file all'inizio di un flusso
_rmtmp Rimuovere i file temporanei creati da tmpfile
scanf, _scanf_l, wscanf, _wscanf_l,scanf_s_scanf_s_l , , , wscanf_s_wscanf_s_l Leggere dati formattati da stdin
setbuf Controllare il buffering del flusso
_setmaxstdio Impostare un massimo per il numero dei file aperti contemporaneamente al livello del flusso I/O.
setvbuf Controllare il buffering del flusso e la dimensione del buffer
_snprintf, _snwprintf, _snprintf_s, _snprintf_s_l, _snwprintf_s_snwprintf_s_l Scrivere dati formattati di lunghezza specificata in una stringa
_snscanf, _snwscanf, _snscanf_s, _snscanf_s_l, _snwscanf_s_snwscanf_s_l Leggere dati formattati di lunghezza specificata dal flusso dello standard input.
sprintf, swprintf, sprintf_s, _sprintf_s_l, swprintf_s_swprintf_s_l Scrivere dati formattati in una stringa
sscanf, swscanf, sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l Leggere dati formattati da una stringa
_tempnam, _wtempnam Creare il filename temporaneo nella directory specificata
tmpfile, tmpfile_s Creare un file temporaneo
tmpnam, _wtmpnam, tmpnam_s_wtmpnam_s Creare un filename temporaneo
ungetc, ungetwc Inserire caratteri in coda al flusso
_vcprintf, _vcwprintf, _vcprintf_s, _vcprintf_s_l, _vcwprintf_s_vcwprintf_s_l Scrivere dati formattati nella console.
vfprintf, vfwprintf, vfprintf_s, _vfprintf_s_l, vfwprintf_s_vfwprintf_s_l Scrivere dati formattati in un flusso
vprintf, vwprintf, vprintf_s, _vprintf_s_l, vwprintf_s_vwprintf_s_l Scrivere dati formattati in stdout
_vsnprintf, _vsnwprintf, vsnprintf_s, _vsnprintf_s_vsnprintf_s_l, , _vsnwprintf_s_vsnwprintf_s_l Scrivere dati formattati di lunghezza specificata nel buffer
vsprintf, vswprintf, vsprintf_s, _vsprintf_s_l, vswprintf_s_vswprintf_s_l Scrivere dati formattati nel buffer

Quando un programma inizia l'esecuzione, il codice di avvio automatico apre più flussi: standard input ((a cui punta stdin), standard output (a cui punta stdout) e standard error (a cui punta stderr)). I flussi vengono indirizzati alla console (tastiera e schermo) per impostazione predefinita. Usare freopen per reindirizzare stdin, stdouto stderr a un file su disco o a un dispositivo.

I file aperti mediante le routine del flusso vengono memorizzati nel buffer per impostazione predefinita. Le stdout funzioni e stderr vengono scaricate ogni volta che sono piene o, se si scrive in un dispositivo carattere, dopo ogni chiamata alla libreria. Se un programma termina in modo anomalo, è possibile che i buffer di output non vengano scaricati, con conseguente perdita di dati. Utilizzare fflush o _flushall per assicurarsi che il buffer associato a un file specificato venga scaricato nel sistema operativo o che tutti i buffer aperti vengano scaricati. Il sistema operativo può memorizzare nella cache i dati prima di scriverli su disco. La funzionalità commit su disco garantisce che il contenuto del buffer scaricato non venga perso in caso di errore di sistema.

Esistono due modi per eseguire il commit del contenuto del buffer su disco:

  • Eseguire il collegamento con il file COMMODE.OBJ per impostare un flag globale di commit. L'impostazione predefinita del flag globale è n, per "no-commit."

  • Impostare il flag della modalità su c con fopen o _fdopen.

Qualsiasi file specificatamente aperto con il flag c o n si comporta in base al flag, indipendentemente dallo stato del flag globale di commit/no-commit.

Se il programma non chiude in modo esplicito un flusso, il flusso viene chiuso automaticamente al termine del programma. Tuttavia, è necessario chiudere un flusso al termine di un programma, perché il numero di flussi che possono essere aperti contemporaneamente è limitato. Per informazioni su questo limite, vedere _setmaxstdio .

L'input può usare direttamente l'output solo con una chiamata corrispondente a fflush o a una funzione di posizionamento di file (fseek, fsetposo rewind). L'input può essere seguito dall'output senza una chiamata di intervento a una funzione di posizionamento dei file, se l'operazione di input rileva la fine del file.

Vedi anche

Input e output
Routine di Universal C Runtime per categoria