3.13 linecache -- Accesso casuale a righe di testo

Il modulo linecache permette di estrapolare qualunque riga da qualsiasi file mentre si cerca di ottimizzare internamente, utilizzando una cache; il caso comune è quello in cui vengono lette molte righe da un singolo file. Questo modulo viene utilizzato dal modulo traceback per recuperare le righe sorgenti col fine di includerle in una traceback formattata.

Il modulo linecache definisce le seguenti funzioni:

getline( nomefile, lineno)
Estrapola la riga lineno dal file chiamato nomefile. Questa funzione non solleverà mai un'eccezione -- restituirà '' sugli errori (il carattere di fine riga verrà incluso in tutte le righe trovate).

Se non viene trovato un file chiamato nomefile la funzione lo cercherà nel percorso di ricerca del modulo, sys.path.

clearcache( )
Ripulisce la cache. Utilizzate questa funzione se non sono più necessarie le righe precedentemente lette utilizzando getline().

checkcache( )
Controlla la validità della cache. Utilizzate questa funzione se i file nella cache possono aver subito delle modifiche sul disco, e ne richiedete la versione aggiornata.

Esempio:

>>> import linecache
>>> linecache.getline('/etc/passwd', 4)
'sys:x:3:3:sys:/dev:/bin/sh\n'
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.