15.7 `readline` -- GNU readline のインタフェース

Unixプラットフォームで利用できます。

readline モジュールでは、補完をしやすくしたり、ヒストリファイルを Python インタプリタから読み書きできるようにするためのいくつかの関数を定義しています。このモジュールは直接使うことも rlcompleter モジュールを介して使うこともできます。このモジュールで利用される設定はインタプリタの対話プロンプトの振舞い、組み込みのraw_input()とinput()関数の振舞いに影響します。

readline モジュールでは以下の関数を定義しています:

parse_and_bind( string): readline 初期化ファイルの行を一行解釈して実行します。

get_line_buffer( ): 行編集バッファの現在の内容を返します。

insert_text( string): コマンドラインにテキストを挿入します。

read_init_file( [filename]): readline 初期化ファイルを解釈します。標準のファイル名設定は最後に使われたファイル名です。

read_history_file( [filename]): readline ヒストリファイルを読み出します。標準のファイル名設定は ~/.history です。

write_history_file( [filename]): readline ヒストリファイルを保存します。標準のファイル名設定は ~/.history です。

clear_history( ): 現在のヒストリをクリアします。 (注意:インストールされている GNU readline がサポートしていない場合、この関数は利用できません) バージョン 2.4 で新たに追加された仕様です。

get_history_length( ): ヒストリファイルに必要な長さを返します。負の値はヒストリファイルのサイズに制限がないことを示します。

set_history_length( length): ヒストリファイルに必要な長さを設定します。この値は write_history_file() がヒストリを保存する際にファイルを切り詰めるために使います。負の値はヒストリファイルのサイズを制限しないことを示します。

get_current_history_length( ): 現在のヒストリ行数を返します(この値はget_history_length()で取得する異なります。get_history_length()はヒストリファイルに書き出される最大行数を返します)。バージョン 2.3 で新たに追加された仕様です。

get_history_item( index): 現在のヒストリから、index 番目の項目を返します。バージョン 2.3 で新たに追加された仕様です。

remove_history_item( pos): ヒストリから指定した位置にあるヒストリを削除します。バージョン 2.4 で新たに追加された仕様です。

replace_history_item( pos, line): 指定した位置にあるヒストリを、指定した line で置き換えます。バージョン 2.4 で新たに追加された仕様です。

redisplay( ): 画面の表示を、現在のヒストリ内容によって更新します。バージョン 2.3 で新たに追加された仕様です。

set_startup_hook( [function]): startup_hook 関数を設定または除去します。function が指定されていれば、新たな startup_hook 関数として用いられます; 省略されるか None になっていれば、現在インストールされているフック関数は除去されます。 startup_hook 関数は readline が最初のプロンプトを出力する直前に引数なしで呼び出されます。

set_pre_input_hook( [function]): pre_input_hook 関数を設定または除去します。function が指定されていれば、新たな pre_input_hook 関数として用いられます; 省略されるか None になっていれば、現在インストールされているフック関数は除去されます。 pre_input_hook 関数は readline が最初のプロンプトを出力した後で、かつ readline が入力された文字を読み込み始める直前に引数なしで呼び出されます。

set_completer( [function]): completer 関数を設定または除去します。function が指定されていれば、新たな completer 関数として用いられます; 省略されるか None になっていれば、現在インストールされている completer 関数は除去されます。 completer 関数は function(text, state) の形式で、関数が文字列でない値を返すまで state を 0, 1, 2, ..., にして呼び出します。この関数は text から始まる文字列の補完結果として可能性のあるものを返さなくてはなりません。

get_completer( ): completer 関数を取得します。completer 関数が設定されていなければ Noneを返します。バージョン 2.3 で新たに追加された仕様です。

get_begidx( ): readline タブ補完スコープの先頭のインデクスを取得します。

get_endidx( ): readline タブ補完スコープの末尾のインデクスを取得します。

set_completer_delims( string): タブ補完のための readline 単語区切り文字を設定します。

get_completer_delims( ): タブ補完のための readline 単語区切り文字を取得します。

add_history( line): 1 行をヒストリバッファに追加し、最後に打ち込まれた行のようにします。

参考:

rlcompleter:モジュール: 対話的プロンプトで Python 識別子を補完する機能。.

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。

15.7 readline -- GNU readline のインタフェース

15.7 `readline` -- GNU readline のインタフェース