GNU Readline によるコマンドライン入力インタフェースを提供するモジュー ルです。
このようにして使います。
require "readline"
while buf = Readline.readline("> ", true)
print "-> ", buf, "\n"
end
Readline.readline([prompt, [add_hist]])ユーザからのキー入力を求め、入力した文字列を返します。EOF(UNIX で は ^D)を入力すると nil を返します。
入力時には行内編集が可能で、vi モードと Emacs モードが用意されています。 (Readline.vi_editing_mode、Readline.emacs_editing_mode を参照)。デフォルトは Emacs モードです。
文字列 prompt を指定するとカーソルの前にこの文字列を表示します。
add_hist が真ならば、入力した文字列はヒストリに記録されます。 Emacs モードなら ^P を入力することで前に入力した文字列を呼び出した り、Readline::HISTORY モジュールによりヒストリの内容を操作す ることができます。このデフォルト値は nil です。
入力待ちの状態で ^C すると ruby インタプリタもろとも終了し端末状 態を復帰しません。これを回避するには、
stty_save = `stty -g`.chomp
begin
while buf = Readline.readline
p buf
end
rescue Interrupt
system("stty", stty_save)
exit
end
または、
stty_save = `stty -g`.chomp
trap("INT") { system "stty", stty_save; exit }
while buf = Readline.readline
p buf
end
などとします。単に、^C を受け付けなくするだけならば以下で十分です。
trap("INT", "SIG_IGN")
while buf = Readline.readline
p buf
end
Readline.completion_proc= proc補完時の動作を決定するProcオブジェクトを指定します。
procは引数に入力文字列を取り、候補文字列の配列を返すように
してください。
入力文字列は単語ごとに区切られます。
bashの補完と同じく/[ \t\n\"\\'`@$><=;|&{(]/で単語に区切ります。*1
require 'readline'
WORDS = %w(foo foobar foobaz)
Readline.completion_proc = proc {|word|
WORDS.grep(/^#{Regexp.quote word}/)
}
while buf = Readline.readline("> ")
p buf
end
Readline.basic_word_break_characters=(str)Readline.basic_word_break_characters補完時の単語同士の区切りを指定する basic な文字列。デフォルトでは Bash用の文字列 " \t\n\"\\'`@$><=;|&{(" (スペース含む)になっています。
Readline.completer_word_break_characters=(str)Readline.completer_word_break_charactersrl_complete_internal() で使われる、補完時の単語同士の区切りを指定する 文字列です。デフォルトでは Readline.basic_word_break_characters です。
Readline.basic_quote_characters=(str)Readline.basic_quote_characters引用符を指定します。デフォルトでは、/"'/ です。
Readline.completer_quote_characters=(str)Readline.completer_quote_character補完時の引用符を指定します。この引用符の間では、completer_word_break_characters も、普通の文字列として扱われます。
Readline.filename_quote_characters=(str)Readline.filename_quote_characters補完時のファイル名の引用符を指定します。デフォルトでは nil です。
Readline.completion_proc補完時の動作を決定するProcオブジェクトを返します。
Readline.completion_case_fold=(bool)Readline.completion_case_fold入力補完時に大文字／小文字の区別をするかどうかを決定します。 bool が真ならば区別しません。
Readline.vi_editing_mode編集モードを vi モードにします。詳細は、GNU Readline のマニュアル を参照してください。
Readline.emacs_editing_mode編集モードを Emacs モードにします。デフォルトは Emacs モードです。
詳細は、GNU Readline のマニュアルを参照してください。
Readline::FILENAME_COMPLETION_PROCReadline::USERNAME_COMPLETION_PROCライブラリに組み込みで用意された補完用 Proc オブジェクトです。 それぞれファイル名、ユーザ名の補完を行います。 Readline.completion_proc= で使用します。
Readline::HISTORYReadlineモジュールで入力した内容は入力履歴として記録されます(有効にし ていればですが。Readline.readline を参照)
この定数により、入力履歴の内容にアクセスすることができます。おおよそ、 Array クラスのインスタンスのように振舞います。 (Enumerable モジュールをextend しています)
while buf = Readline.readline("> ", true)
p Readline::HISTORY.to_a
print "-> ", buf, "\n"
end
空行や直前の入力と同じ内容は入力履歴に残したくないと思うかも知れません。 この場合、以下のようにします。
while buf = Readline.readline("> ", true)
# p Readline::HISTORY.to_a
Readline::HISTORY.pop if /^\s*$/ =~ buf
begin
Readline::HISTORY.pop if Readline::HISTORY[Readline::HISTORY.length-2] == buf
rescue IndexError
end
# p Readline::HISTORY.to_a
print "-> ", buf, "\n"
end
以上が追加されました。
*1るびきち：[2001/12/12]ここの部分ではまったので。