X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=filestd.tex;h=c189164ceefd7685c65ca99256c3269ffbb63f1d;hp=214fb2046721292044a5c27302ae77e3be99399d;hb=dcf2c2df897955ff3503a7c426025457ab456fd7;hpb=ffb12837c5ed8ccc095bc9c88349cd19b5e6b472;ds=sidebyside diff --git a/filestd.tex b/filestd.tex index 214fb20..c189164 100644 --- a/filestd.tex +++ b/filestd.tex @@ -460,13 +460,13 @@ effettuato ogni volta che si chiama una funzione di libreria. Entrambi i flag (di errore e di end-of-file) possono essere cancellati usando la funzione \funcd{clearerr}, il cui prototipo è: \begin{prototype}{stdio.h}{void clearerr(FILE *stream)} - Cancella i flag di errore ed end-of-file di \param{stream}. + Cancella i flag di errore ed \textit{end-of-file} di \param{stream}. \end{prototype} \noindent in genere si usa questa funzione una volta che si sia identificata e corretta la causa di un errore per evitare di mantenere i flag attivi, così da poter rilevare una successiva ulteriore condizione di errore. Di questa -funzione esiste una analoga \func{clearerr\_unlocked} che non esegue il blocco -dello \textit{stream} (vedi sez.~\ref{sec:file_stream_thread}). +funzione esiste una analoga \funcm{clearerr\_unlocked} che non esegue il +blocco dello \textit{stream} (vedi sez.~\ref{sec:file_stream_thread}). \subsection{Input/output binario} @@ -1166,8 +1166,10 @@ inoltre ricordarsi di invocare \func{free} per liberare detto puntatore quando la stringa non serve più, onde evitare \itindex{memory~leak} \textit{memory leak}. -Infine una ulteriore estensione GNU definisce le due funzioni \func{dprintf} e -\func{vdprintf}, che prendono un file descriptor al posto dello +% TODO verificare se mettere prototipi di \func{dprintf} e \func{vdprintf} + +Infine una ulteriore estensione GNU definisce le due funzioni \funcm{dprintf} e +\funcm{vdprintf}, che prendono un file descriptor al posto dello \textit{stream}. Altre estensioni permettono di scrivere con caratteri estesi. Anche queste funzioni, il cui nome è generato dalle precedenti funzioni aggiungendo una \texttt{w} davanti a \texttt{print}, sono trattate in @@ -1195,8 +1197,8 @@ famiglia \func{scanf}; fra queste le tre più importanti sono \funcd{scanf}, di errore o fine del file viene invece restituito \val{EOF}.} \end{functions} \noindent e come per le analoghe funzioni di scrittura esistono le relative -\func{vscanf}, \func{vfscanf} \func{vsscanf} che usano un puntatore ad una -lista di argomenti. +\funcm{vscanf}, \funcm{vfscanf} e \funcm{vsscanf} che usano un puntatore ad +una lista di argomenti. Tutte le funzioni della famiglia delle \func{scanf} vogliono come argomenti i puntatori alle variabili che dovranno contenere le conversioni; questo è un @@ -1324,6 +1326,7 @@ gran parte dei casi un intero a 32 bit, questo diventa un problema quando la posizione sul file viene espressa con un valore a 64 bit come accade nei sistemi più moderni. +% TODO: mettere prototipi espliciti fseeko e ftello o menzione? \section{Funzioni avanzate} @@ -1526,6 +1529,8 @@ scelta, si può forzare lo scarico dei dati sul file con la funzione \macro{\_SVID\_SOURCE} o \macro{\_GNU\_SOURCE}.} che non effettua il blocco dello stream. +% TODO aggiungere prototipo \func{fflush\_unlocked}? + Se \param{stream} è \val{NULL} lo scarico dei dati è forzato per tutti gli \textit{stream} aperti. Esistono però circostanze, ad esempio quando si vuole essere sicuri che sia stato eseguito tutto l'output su terminale, in cui serve @@ -1644,6 +1649,9 @@ con \param{type}, che può essere uno dei seguenti: di blocco dello \textit{stream}. \end{basedescript} +% TODO trattare \func{clearerr\_unlocked} + + \itindend{thread}