Rilettura e inizio degli stream
[gapil.git] / filestd.tex
1 \chapter{I file: l'interfaccia standard ANSI C}
2 \label{cha:files_std_interface}
3
4 Esamineremo in questo capitolo l'interfaccia standard ANSI C per i file,
5 quella che viene comunemente detta interfaccia degli \textit{stream}.
6 Dopo una breve sezione introduttiva tratteremo le funzioni base per la
7 gestione dell'input/output, mentre tratteremo le caratteristiche più aanzate
8 dell'interfaccia nell'ultima sezione.
9
10
11 \section{Introduzione}
12 \label{sec:file_stream_intro}
13
14 Come visto in \capref{cap:file_unix_interface} le operazioni di I/O sui file
15 sono gestibili direttamente a basso livello con l'interfaccia standard unix
16 che ricorre direttamente alle system call messe a disposizione dal kernel.
17
18 Questa interfaccia però non provvede le funzionalità previste dallo standard
19 ANSI C che invece sono realizzate attraverso opportune funzioni di libreria,
20 che vengono a costituire il nucleo essenziale\footnote{queste funzioni sono
21   state implementate la prima volta da Ritchie nel 1976 e da allora sono
22   rimaste sostanzialmente immutate.} delle \acr{glibc}.
23
24
25 \subsection{I \textit{file stream}}
26 \label{sec:file_stream}
27
28 Come più volte ribadito l'interfaccia dei file descriptor è una interfaccia di
29 basso livello, che non provvede nessuna forma di formattazione dei dati, e
30 nessuna forma di bufferizzazione per ottimizzare le operazioni di I/O.
31
32 In \textit{Advanced Programming in the Unix Environment} Stevens esegue un
33 raffronto dell'influenza delle dimensioni del blocco di dati (il parametro
34 \param{buf} di \func{read} e \func{write}) nell'efficienza nelle operazioni di
35 I/O con i file descriptor, evidenziando come le prestazioni ottimali si
36 ottengano quando il buffer dei dati ha la stessa dimensione dei blocchi del
37 filesystem (il valore dato dal campo \var{st\_blksize} di \var{fstat}).
38
39 In questo caso se il porgrammatore non si cura di effettuare le operazioni in
40 blocchi di dimensioni adeguate, le prestazioni possono deteriorarsi in maniera
41 evidetne. L'interfaccia degli stream provvede da sola la gestione dei dettagli
42 della bufferizzazione e dell'esecuzione delle operazioni di lettura e
43 scrittura effettive in blocchi di dimensioni appropriate all'ottenimento della
44 massima efficienza.
45
46 Per questo motivo l'interfaccia viene chiamata anche interfaccia dei
47 \textit{file stream}, dato che non è più necessario doversi preoccupare di
48 gestire i dettagli della comunicazione con il tipo di hardware sottostante, ed
49 esso può essere sempre considerato come composto da un flusso (da cui il nome
50 \textit{stream}) continuo di dati.
51
52 Ma a parte le particolarità della gestione delle operazioni di lettura e
53 scrittura, i file stream restano del tutto equivalenti ai file descriptor sui
54 quali sono basati, ed in particolare vale quanto visto in
55 \secref{sec:file_sharing} a proposito dell'accesso condiviso ed in
56 \secref{sec:file_access_control} per il controllo di accesso.
57
58
59 \subsection{Gli oggetti \type{FILE}}
60 \label{sec:file_FILE}
61
62 Per ragioni storiche la struttura di dati che rappresenta un stream è stata
63 chiamata \type{FILE}, questi oggetti sono creati dalle funzioni di libreria e
64 contengono tutte le informazioni necessarie a gestire le operazioni sugli
65 stream, come la posizione corrente, lo stato del buffer e degli indicatori di
66 stato e di fine del file.
67
68 Per questo motivo gli utenti non devono mai utilizzare direttamente o allocare
69 queste strutture, ma usare sempre puntatori del tipo \type{FILE *} ottenuti
70 dalla libreria stessa (tanto che in certi casi il termine di puntatore a file
71 è diventato sinonimo di stream). 
72
73 Tutte le funzioni della libreria che operano sui file accettano come parametri
74 solo variabili di questo tipo, che diventa accessibile includendo l'header
75 file \file{stdio.h}.
76
77
78
79 \subsection{Gli stream standard}
80 \label{sec:file_std_stream}
81
82 Ai tre file descriptor standard (vedi \secref{sec:file_std_descr}) aperti per
83 ogni processo, corrispondono altrettanti stream predefiniti per ogni processo,
84 che rappresentano i canali standard di input/output prestabiliti; anche questi
85 tre stream sono definiti nell'header \file{stdio.h} e sono:
86
87 \begin{itemize}
88 \item \var{FILE * stdin} Lo \textit{standard input} cioè lo stream da cui
89   il processo riceve ordinariamente i dati in ingresso. Normalmente è associato
90   dalla shell all'input del terminale e prende i caratteri dalla tastiera.
91 \item \var{FILE * stdout} Lo \textit{standard input} cioè lo stream su cui
92   il processo invia ordinariamente i dati in uscita. Normalmente è associato
93   dalla shell all'output del terminale e scrive sullo schermo.
94 \item \var{FILE * stderr} Lo \textit{standard input} cioè lo stream su cui
95   il processo è supposto inviare i messaggi di errore. Normalmente anch'esso
96   è associato dalla shell all'output del terminale e scrive sullo schermo.
97 \end{itemize}
98
99 Nelle \acr{glibc} \var{stdin}, \var{stdout} e \var{stderr} sono effettivamente
100 tre variabili che possono essere usate come tutte le altre, ad esempio si può
101 effettuare una redirezione dell'ouput di un programma con il semplice codice:
102 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
103     fclose (stdout);
104     stdout = fopen ("standard-output-file", "w");
105 \end{lstlisting}
106 ma in altri sistemi possono essere definite come macro, e deve essere pertanto
107 usata \func{freopen}.
108
109
110 \subsection{Le modalità di bufferizzazione}
111 \label{sec:file_buffering}
112
113
114 \section{Funzioni base}
115 \label{sec:file_ansi_base_func}
116
117 Esamineremo in questa sezione le funzioni base dell'interfaccia degli stream,
118 che provvedono le modalità per crearli, e le funzioni disponibili per leggere,
119 scrivere e compiere le varie operazioni connesse all'uso dei file.
120
121
122 \subsection{Apertura di uno stream}
123 \label{sec:file_fopen}
124
125
126 \subsection{Lettura e scrittura su uno stream}
127 \label{sec:file_io}
128
129
130 \subsection{Posizionamento su uno stream}
131 \label{sec:file_fseek}
132
133
134 \subsection{Input/output binario}
135 \label{sec:file_binary_io}
136
137
138 \subsection{Input/output di linea}
139 \label{sec:file_line_io}
140
141
142 \subsection{Input/output formattato}
143 \label{sec:file_formatted_io}
144
145
146 \subsection{Chiusura di uno stream}
147 \label{sec:file_fclose}
148
149
150 \section{Funzioni avanzate}
151 \label{sec:file_stream_adv_func}
152
153
154 \subsection{Il controllo della bufferizzazione}
155 \label{sec:file_buffering-ctrl}
156
157
158 \subsection{Dettagli dell'implementazione}
159 \label{sec:file_stream_details}
160
161
162 \subsection{File temporanei}
163 \label{sec:file_temp_file}
164
165
166 \subsection{Efficienza}
167 \label{sec:file_stream_efficiency}
168
169
170
171
172
173
174
175
176