\begin{prototype}{stdio.h}{int fclose(FILE * stream)}
Chiude lo stream \param{stream}.
- Restituisce 0 in caso di successo e \macro{EOF} in caso di errore, nel qual
- caso setta \var{errno} a \macro{EBADF} se il file descriptor indicato da
- \param{stream} non è valido, o uno dei valori specificati dalla sottostante
- funzione che è fallita (\func{close}, \func{write} o \func{fflush}).
+ \bodydesc{Restituisce 0 in caso di successo e \macro{EOF} in caso di errore,
+ nel qual caso setta \var{errno} a \macro{EBADF} se il file descriptor
+ indicato da \param{stream} non è valido, o uno dei valori specificati
+ dalla sottostante funzione che è fallita (\func{close}, \func{write} o
+ \func{fflush}).}
\end{prototype}
La funzione effettua uno scarico di tutti i dati presenti nei buffer di
\begin{prototype}{stdio.h}{int fcloseall(void)}
Chiude tutti gli stream.
- Restituisce 0 se non ci sono errori ed \macro{EOF} altrimenti.
+ \bodydesc{Restituisce 0 se non ci sono errori ed \macro{EOF} altrimenti.}
\end{prototype}
la funzione esegue lo scarico dei dati bufferizzati in uscita e scarta quelli
in ingresso, chiudendo tutti i file. Questa funzione è provvista solo per i
\funcdecl{size\_t fwrite(const void * ptr, size\_t size, size\_t
nmemb, FILE * stream)}
- Le funzioni rispettivamente leggono e scrivono \param{nmemb} elementi
- di dimensione \param{size} dal buffer \param{ptr} al file
- \param{stream}.
+ Rispettivamente leggono e scrivono \param{nmemb} elementi di dimensione
+ \param{size} dal buffer \param{ptr} al file \param{stream}.
- Entrambe le funzioni ritornano il numero di elementi letti o scritti,
- in caso di errore o fine del file viene restituito un numero di
- elementi inferiore al richiesto.
+ \bodydesc{Entrambe le funzioni ritornano il numero di elementi letti o
+ scritti, in caso di errore o fine del file viene restituito un numero di
+ elementi inferiore al richiesto.}
\end{functions}
In genere si usano queste funzioni quando si devono trasferire su file
\funcdecl{size\_t fwrite\_unlocked(const void * ptr, size\_t size,
size\_t nmemb, FILE * stream)}
- Le funzioni sono identiche alle analoghe \func{fread} e \func{fwrite}
- ma non acquisiscono il lock implicito sullo stream.
+ \bodydesc{Le funzioni sono identiche alle analoghe \func{fread} e
+ \func{fwrite} ma non acquisiscono il lock implicito sullo stream.}
\end{functions}
\noindent entrambe le funzioni sono estensioni GNU previste solo dalle
\acr{glibc}.
\funcdecl{int fgetc(FILE *stream)} Legge un byte da \param{stream} e lo
restituisce come intero. È una sempre una funzione.
- \funcdecl{int getchar(void)} è equivalente a \func{getc(stdin)}.
+ \funcdecl{int getchar(void)} Equivalente a \func{getc(stdin)}.
\bodydesc{Tutte queste funzioni leggono un byte alla volta, che viene
restituito come intero; in caso di errore o fine del file il valore
\funcdecl{wint\_t fgetwc(FILE *stream)} Legge un carattere esteso da
\param{stream} È una sempre una funzione.
- \funcdecl{wint\_t getwchar(void)} è equivalente a \func{getwc(stdin)}.
+ \funcdecl{wint\_t getwchar(void)} Equivalente a \func{getwc(stdin)}.
\bodydesc{Tutte queste funzioni leggono un carattere alla volta, in
caso di errore o fine del file il valore di ritorno è \macro{WEOF}.}
\funcdecl{int fputc(FILE *stream)} Scrive il carattere \param{c} su
\param{stream}. È una sempre una funzione.
- \funcdecl{int putchar(void)} è equivalente a \func{putc(stdin)}.
+ \funcdecl{int putchar(void)} Equivalente a \func{putc(stdin)}.
\bodydesc{Le funzioni scrivono sempre un carattere alla volta, il cui
valore viene restituito in caso di successo; in caso di errore o