7.20 `readline` -- Interfaccia a GNU readline

Disponibilit�: Unix.

Il modulo readline definisce un numero di funzioni usate o direttamente o dal modulo rlcompleter per facilitare il completamento e la lettura/scrittura del file storico da parte dell'interprete Python.

Il modulo readline definisce le seguenti funzioni:

parse_and_bind( string): Analizza ed esegue una singola riga di un file di inizializzazione readline.

get_line_buffer( ): Restituisce i contenuti correnti del buffer di riga.

insert_text( string): Inserisce del testo nella riga di comando.

read_init_file( [filename]): Analizza un file di inizializzazione readline. Il filename predefinito � l'ultimo filename usato.

read_history_file( [filename]): Carica un file storico della readline. Il nome del file predefinito � ~/.history.

write_history_file( [filename]): Salva un file storico della readline. Il nome del file predefinito � ~/.history.

clear_history( ): Cancella lo storico corrente. (Nota: questa funzione non � disponibile se la versione della GNU readline installata non la supporta.) Nuovo nella versione 2.4.

get_history_length( ): Restituisce la lunghezza desiderata del file dello storico. Valori negativi implicano una dimensione illimitata del file dello storico.

set_history_length( length): Imposta il numero di righe da salvare nel file dello storico. write_history_file() sfrutta questo valore per troncare il file dello storico durante il salvataggio. Valori negativi implicano una dimensione illimitata del file dello storico.

get_current_history_length( ): Restituisce il numero di righe immagazzinate al momento nello storico. Questo � differente da get_history_length(), che restituisce il massimo numero di righe che possono essere scritte nel file dello storico. Nuovo nella versione 2.3.

get_history_item( index): Restituisce il contenuto corrente degli elementi dello storico in index. Nuovo nella versione 2.3.

redisplay( ): Cambia la visualizzazione sullo schermo per riflettere il contenuto corrente del buffer di riga. Nuovo nella versione 2.3.

set_startup_hook( [function]): Imposta o rimuove la funzione di startup_hook. Se function viene specificata, verr� usata come nuova funzione di startup_hook; se viene omessa o � None, ogni funzione di aggancio gi� installata viene rimossa. La funzione di startup_hook viene chiamata senza argomenti appena prima che readline stampi il primo prompt.

set_pre_input_hook( [function]): Imposta o rimuove la funzione di pre_input_hook. Se function viene specificata, sar� usata come nuova funzione di pre_input_hook; se � omessa o � None, ogni funzione di aggancio gi� installata viene rimossa. La funzione di startup_hook viene chiamata senza argomenti dopo che il primo prompt � stato stampato e appena prima che readline inizi la lettura dei caratteri in input.

set_completer( [function]): Imposta o rimuove la funzione di completamento. Se function viene specificata, sar� usata come nuova funzione di completamento; se viene omessa o � None, ogni funzione di completamento gi� installata viene rimossa. La funzione di completamento viene chiamata come function(text, state), con state in 0, 1, 2, ..., finch� non restituisce un valore diverso da una stringa. Dovrebbe restituire il prossimo completamento possibile che comincia con text.

get_completer( ): Restituisce la funzione di completamento, o None se non � stata impostata alcuna funzione di completamento. Nuovo nella versione 2.3.

get_begidx( ): Restituisce l'indice iniziale da cui partirebbe con il completamento tramite tab, readline.

get_endidx( ): Restituisce l'indice finale che aggiungerebbe con il completamento tramite tab, readline.

set_completer_delims( string): Imposta i delimitatori di parola di readline per il completamento tramite tab.

get_completer_delims( ): Restituisce i delimitatori di parola di readline per il completamento tramite tab.

add_history( line): Aggiunge una riga allo storico nel buffer, come se fosse l'ultima riga digitata.

Vedete anche:

Modulo rlcompleter:: Completamento degli identificatori Python al prompt interattivo.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.

7.20 readline -- Interfaccia a GNU readline

7.20 `readline` -- Interfaccia a GNU readline