Visualizza wikitesto di Stdio.h

{{Libreria_standard_C}}
{{Titolo minuscolo}}
'''stdio.h''', che sta per "standard input-output header", è l'[[header file]] della [[libreria standard del C]] che contiene definizioni di [[Macro (informatica)|macro]], costanti e dichiarazioni di funzioni e tipi usati per le varie operazioni di [[input/output]]. È compatibile con il [[C++]], anche se quest'ultimo linguaggio di programmazione usa anche l'header file '''cstdio''', che aggiunge alcune [[overloading|funzioni sovraccariche]] per lavorare anche con le variabili '''long'''.

Le funzioni dichiarate in <code>stdio.h</code> sono molto famose, poiché, essendo parte della [[libreria standard del C]], il loro funzionamento è garantito su ogni piattaforma per la quale esista un [[compilatore]] [[C (linguaggio)|C]]. Le applicazioni studiate per una particolare piattaforma, però, potrebbero utilizzare direttamente le chiamate di I/O del [[sistema operativo]], piuttosto che le funzioni di <code>stdio.h</code>.

== Esempio di utilizzo ==
Tutte le funzioni, in [[C (linguaggio)|C]] e nei suoi derivati, sono dichiarate negli [[header file]]. Il programmatore, perciò, deve includere l'header <code>stdio.h</code> nel codice sorgente per poter utilizzare le funzioni dichiarate al suo interno.

<syntaxhighlight lang="c">
#include <stdio.h>

int main(void)
{
  int c;

  while ((c = getchar()) != EOF)
    putchar(c);
  putchar('\n');

  return 0;
}
</syntaxhighlight>

Il [[programma (informatica)|programma]] qui sopra legge tutto l'input dallo '''standard input''' e lo visualizza sullo '''standard output''', carattere per carattere.

== Funzioni ==
Le funzioni dichiarate in <code>stdio.h</code> possono generalmente essere divise in due categorie: le funzioni per la manipolazione di file e quelle per la manipolazione dell'input/output.

{| class="wikitable"
|- bgcolor=#e9e9e9
! Nome||Descrizione
|- bgcolor=#f2f2f2
|colspan=2 align=center|<span style="font-size: 120%;">Funzioni per la manipolazione di file</span>
|-
|<code>fclose</code> || Chiude il file associato al valore <code>FILE *</code> passatole.
|-
|<code>fopen, freopen, fdopen[[#Non_standard|*]]</code> || Apre un file in lettura o scrittura.
|-
|<code>remove</code> || Rimuove un file.
|-
|<code>rename</code> || Rinomina un file.
|-
|<code>rewind</code> || Agisce come se fosse stata chiamata la funzione <code>fseek(stream, 0L, SEEK_SET)</code> sullo stream passatole; in aggiunta, cancella il suo indicatore d'errore.
|-
|<code>tmpfile</code> || Crea ed apre un file temporaneo, che viene poi cancellato e chiuso con <code>fclose()</code>.
|-bgcolor=#f2f2f2
|colspan=2 align=center|<span style="font-size: 120%;">Funzioni per la manipolazione dell'input/output</span>
|-
|<code>clearerr</code> || Cancella l'indicatore di [[fine file]] e quello d'errore per un dato stream.
|-
|<code>feof</code> || Controlla se l'indicatore di [[fine file]] è stato settato per un dato stream.
|-
|<code>ferror</code> || Controlla se l'indicatore d'errore è stato settato per un dato stream.
|-
|<code>fflush</code> || Forza lo svuotamento del [[buffer]] '''output''' per un dato stream, provocando l'immediata scrittura su file.
|-
|<code>fgetpos</code> || Salva la posizione corrente associata allo stream passato come primo argomento (un <code>FILE *</code>) nel secondo argomento passatole (un <code>fpos_t *</code>).
|-
|<code>fgetc</code> || Restituisce un carattere da un file.
|-
|<code>fgets</code> || Restituisce una [[Stringa (informatica)|stringa]] presa da un file, terminata da un carattere di nuova riga (<code>'\n'</code>) o dal carattere nullo (<code>'\0'</code>).
|-
|<code>fputc</code> || Scrive un carattere su un file.
|-
|<code>fputs</code> || Scrive una [[Stringa (informatica)|stringa]] su un file.
|-
|<code>ftell</code> || Restituisce un indicatore di posizione sul file che può essere passato alla funzione <code>fseek()</code>.
|-
|<code>fseek</code> || Si sposta attraverso un file.
|-
|<code>fsetpos</code> || Imposta l'indicatore di posizionamento del file di uno stream associato al primo argomento (un <code>FILE *</code>) come memorizzato nel suo secondo argomento (un <code>fpos_t *</code>).
|-
|<code>fread</code> || Legge da file dei dati di diverse dimensioni.
|-
|<code>fwrite</code> || Scrive su file dei dati di diverse dimensioni.
|-
|<code>getc</code> || Legge e restituisce un carattere dallo stream passatole ed incrementa l'indicatore di posizionamento nel file; è possibile che venga implementato come macro con gli stessi effetti di <code>fgetc()</code>, tranne che potrebbe agire sullo stream più di una volta.
|-
|<code>ungetc</code> || Restituisce allo stream almeno un carattere. Alla successiva chiamata di <code>getc</code> verrà passato il carattere restituito da <code>ungetc</code>
|-
|<code>getchar</code> || Ha gli stessi effetti di <code>getc(stdin)</code>.
|-
|<code>gets<sup>(1)</sup></code> || Legge caratteri da <code>stdin</code> finché non incontra un carattere di nuova riga (''newline'') o un EOF e salva il risultato nell'argomento passatole (<code>char *</code>).
|-
|<code>printf, fprintf, sprintf, snprintf</code> || Utilizzato per stampare vari tipi di dato su <code>stdout</code>.
|-
|<code>vprintf</code> || Anch'essa utilizzata per stampare su <code>stdout</code>.
|-
|<code>perror</code> || Scrive un messaggio di errore su <code>stderr</code>.
un carattere in uno stream di input.
|-
|<code>puts</code> || Scrive una [[Stringa (informatica)|stringa]] su <code>stdout</code>.
|}

; {{anchor|Non_standard}} Note
: * Non parte dello standard ISO.
: <sup>(1)</sup> Rimossa nello standard C11.

== Costanti ==
Le costanti definite in <code>stdio.h</code> includono:
{| class="wikitable"
|- bgcolor=#e9e9e9
! Nome !! Valore !! Descrizione
|-
|<code>EOF</code> ||  || Un [[Numero intero (informatica)|numero intero]]  negativo di tipo <code>int</code> usato per indicare la condizione di raggiunto [[fine file]].
|-
|<code>BUFSIZ</code>  ||  || Un [[Numero intero (informatica)|intero]] indicante la dimensione del [[buffer]] usato dalla funzione <code>setbuf()</code>.
|-
|<code>FILENAME_MAX</code>  || || La dimensione di un [[array]] di <code>char</code> grande abbastanza da contenere il nome di un qualsiasi file gestibile su una particolare architettura.
|-
|<code>FOPEN_MAX</code>  || <code>>= 8</code> || Il numero minimo di file che possono essere aperti contemporaneamente in una particolare implementazione architettura.
|-
|<code>_IOFBF</code>  || || Abbreviazione di ''"I/O fully buffered"'', cioè "I/O completamente bufferizzato"; è un [[Numero intero (informatica)|intero]] che può essere passato alla funzione <code>setvbuf()</code> per richiedere che uno stream sia bufferizzato a blocchi.
|-
|<code>_IOLBF</code>  ||  || Abbreviazione di ''"I/O line buffered"'', cioè "I/O bufferizzato per linee"; è un [[Numero intero (informatica)|intero]] che può essere passato alla funzione <code>setvbuf()</code> per richiedere che uno stream sia bufferizzato per linee.
|-
|<code>_IONBF</code>  ||  || Abbreviazione di ''"I/O not buffered"'', cioè "I/O non bufferizzato"; è un [[Numero intero (informatica)|intero]] che può essere passato alla funzione <code>setvbuf()</code> per richiedere che uno stream non sia bufferizzato.
|-
|<code>L_tmpnam</code>  || || La dimensione di un [[array]] di <code>char</code> grande abbastanza per conservare il nome di file temporaneo generato dalla funzione <code>tmpnam()</code>.
|-
|<code>NULL</code>  || Generalmente viene definito come <code>0</code>, oppure <code>0L</code>, oppure <code>(void*)0</code> || Una [[Macro (informatica)|macro]] che espande nella costante [[Puntatore (programmazione)#Il puntatore null|puntatore nullo]]; in altre parole, una costante che rappresenta un valore che è garantito essere l'indirizzo di una posizione '''non''' valida nella memoria. 
|-
|<code>SEEK_CUR</code>  || || Un [[Numero intero (informatica)|intero]] che può essere passato alla funzione <code>fseek()</code> per richiedere un posizionamento relativo rispetto alla posizione attuale nel file.
|-
|<code>SEEK_END</code>  ||  || Un [[Numero intero (informatica)|intero]] che può essere passato alla funzione <code>fseek()</code> per richiedere il posizionamento alla fine del file.
|-
|<code>SEEK_SET</code>  || || Un [[Numero intero (informatica)|intero]] che può essere passato alla funzione <code>fseek()</code> per richiedere il posizionamento all'inizio del file.
|-
|<code>TMP_MAX</code>  || <code>>= 25</code> || Il massimo numero di nomi di file unici generabili dalla funzione <code>tmpnam()</code>.
|}

== Variabili ==
Le variabili definite in <code>stdio.h</code> includono:
{| class="wikitable"
|- bgcolor=#e9e9e9
! Nome||Descrizione
|-
|<code>stdin</code> || Un [[puntatore (programmazione)|puntatore]] a <code>FILE</code> che si riferisce allo stream di standard input, generalmente la tastiera.
|-
|<code>stdout</code> || Un [[puntatore (programmazione)|puntatore]] a <code>FILE</code> che si riferisce allo stream di standard output, generalmente un terminale.
|-
|<code>stderr</code>  || Un [[puntatore (programmazione)|puntatore]] a <code>FILE</code> che si riferisce allo stream di standard error, generalmente un terminale.
|}

== Tipi di dato ==
I tipi di dato definiti in <code>stdio.h</code> sono:
{| class="wikitable"
|- bgcolor=#e9e9e9
! Nome||Descrizione
|-
| <code>FILE</code> || Una [[struttura dati#Record o struttura|struttura]] contenente le informazioni su un file (o in genere uno stream), necessarie per eseguire su di esso le operazioni di input/output, come ad esempio:
* la posizione attuale nello stream
* un indicatore di [[fine file]]
* un indicatore d'errore
* un puntatore al buffer dello stream, se applicabile
|-
| <code>fpos_t</code> || Un tipo scalare capace di identificare univocamente la posizione di ogni byte in un file.
|-
| <code>size_t</code> || Un tipo [[Numero intero (informatica)|intero]] che è il tipo del valore restituito dall'[[operatore (informatica)|operatore]] <code>[[sizeof]]</code>.
|}

== Altri progetti ==
{{interprogetto|b=C/Appendice/Librerie standard/stdio.h}}

== Collegamenti esterni ==
* {{cita web|http://code-reference.com/c/stdio.h|stdio.h reference on Coding Programmer Page / C Library Reference and Examples|lingua=en}}
* {{en}} [http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/stdio.h.html stdio.h] da The Open Group Base Specifications Issue 7
* {{cita web|1=http://www.cplusplus.com/reference/clibrary/cstdio/|2=C library to perform Input/Output operations|lingua=en|accesso=5 luglio 2012|dataarchivio=7 luglio 2012|urlarchivio=https://web.archive.org/web/20120707004421/http://www.cplusplus.com/reference/clibrary/cstdio/|urlmorto=sì}}
* [https://web.archive.org/web/20101124224627/http://appuntilinux.mirror.garr.it/mirrors/appuntilinux/a2/a295.htm#almltitle4141 69.17 File «stdio.h»] da [[Appunti di informatica libera]]

[[Categoria:Libreria standard del C]]