Aprire un File in Linguaggio C

Apertura di un File

La funzione che la libreria standard del C mette a disposizione per aprire un file è la funzione fopen, che sta per file open. La sua firma è la seguente:

#include <stdio.h>

FILE *fopen(const char * restrict filename,
            const char * restrict mode);

Il primo argomento della funzione fopen rappresenta una stringa che contiene il nome (il percorso o path più precisamente) del file da aprire. Il percorso contiene tutte le informazioni necessarie per localizzare il file nel file system, inclusi eventuali directory o sottodirectory. Esso può essere:

• assoluto: specifica il percorso completo dalla radice del file system (ad esempio, /home/utente/documenti/file.txt).
• relativo: specifica un percorso relativo alla directory di lavoro corrente (ad esempio, documenti/file.txt), dove per directory di lavoro corrente si intende la directory in cui si trova il programma in esecuzione.

C:\percorso\file.txt

FILE *file = fopen("C:\\percorso\\file.txt", "r");

FILE *file = fopen("C:/percorso/file.txt", "r");

Il secondo argomento rappresenta una stringa che indica la modalità di accesso ossia si specifica quali operazioni si intendono effettuare sul file in questione. Un esempio è la modalità "r" che indica che il file deve essere aperto in modalità lettura. Vedremo nella prossima sezione le modalità in dettaglio.

Notiamo due dettagli fondamentali riguardanti i parametri della funzione fopen:

• I parametri sono puntatori a char di tipo restrict:

  Questo significa che le due stringhe, filename e mode, non devono sovrapporsi in memoria.

• Il parametro mode è un puntatore a char, ossia una stringa e non rappresenta un singolo carattere. Infatti esso può essere composto da una sequenza di caratteri.

La funzione fopen restituisce un puntatore a un oggetto FILE che rappresenta il file aperto, oppure NULL se si è verificato un errore durante l'apertura del file.

Tale puntatore deve essere salvato in una variabile per poi accedervi con altre funzioni nel resto del programma. Ad esempio:

FILE *file = fopen("esempio.txt", "r");

Le altre funzioni di accesso a file richiedono in ingresso il puntatore restituito da fopen. Le vedremo nelle prossime lezioni.

Di solito, quando fopen fallisce, ossia non riesce per vari motivi ad aprire il file, restituisce il valore NULL.

FILE *file = fopen("esempio.txt", "r");

if (file == NULL) {
    perror("Errore nell'apertura del file");
    return 1;
}

Modalità di Accesso ai File

Abbiamo detto che il secondo parametro della funzione fopen permette di specificare la modalità di accesso al file.

Attraverso questo parametro, però, non si specifica solo la modalità di accesso ma anche il tipo di file, ossia se il file che si sta andando ad aprire sia un file di testo o un file binario. Quindi, le modalità di accesso si dividono in due gruppi a seconda del tipo di file.

Se il file a cui si vuole accedere è un file di testo, il parametro mode può assumere uno dei seguenti valori:

Viceversa, se il file è un file binario, il parametro mode può assumere uno dei seguenti valori che sono simili ai precedenti ma in cui aggiungiamo una b:

Come si può osservare dalle due tabelle di sopra, la libreria standard del C distingue la scrittura su file in due modalità: writing (scrittura) e append (scrittura in coda o aggiunta).

Quando si apre un file in modalità scrittura, normalmente il file viene troncato (truncated), ossia se il file esisteva già, il suo contenuto viene eliminato e il file viene riempito con nuovi dati a partire dall'inizio.

Viceversa, se si apre un file in modalità append, i dati vengono scritti alla fine del file preservando il vecchio contenuto; questo ovviamente se il file esisteva già. Per questo si parla di append o aggiunta.

Le modalità ibride di lettura/scrittura, invece, richiedono particolare attenzione. Non si può leggere prima e poi scrivere (o viceversa) senza gestire correttamente la posizione nel file. La posizione nel file rappresenta l'offset corrente da cui si legge o si scrive. Ritorneremo su questo concetto nelle prossime lezioni in cui lo studieremo in dettaglio.