Ruby Readline.completion_proc =用法及代碼示例

completion_proc = proc

指定 Proc 對象 proc 以確定完成行為。它應該接受輸入字符串並返回一個完成候選數組。

如果 proc 為 nil，則使用默認完成。

傳遞給 Proc 的 String 取決於 Readline.completer_word_break_characters 屬性。默認情況下，光標下的單詞被傳遞給 Proc 。例如，如果輸入是 “foo bar” 那麽隻有 “bar” 會被傳遞給完成 Proc 。

成功完成後， Readline.completion_append_character 將附加到輸入中，以便用戶可以開始處理他們的下一個參數。

例子

完成靜態列表

require 'readline'

LIST = [
  'search', 'download', 'open',
  'help', 'history', 'quit',
  'url', 'next', 'clear',
  'prev', 'past'
].sort

comp = proc { |s| LIST.grep(/^#{Regexp.escape(s)}/) }

Readline.completion_append_character = " "
Readline.completion_proc = comp

while line = Readline.readline('> ', true)
  p line
end

完成目錄內容

require 'readline'

Readline.completion_append_character = " "
Readline.completion_proc = Proc.new do |str|
  Dir[str+'*'].grep(/^#{Regexp.escape(str)}/)
end

while line = Readline.readline('> ', true)
  p line
end

自動完成策略

使用 auto-complete 時，有些策略效果很好。要獲得一些想法，您可以查看 irb 的completion.rb 文件。

常見的策略是獲取可能的完成列表並將其過濾到以用戶輸入開頭的那些完成。在上述示例中，使用了 Enumerator.grep 。輸入被轉義以防止 Regexp 特殊字符幹擾匹配。

使用 Abbrev 庫生成補全也可能會有所幫助。

如果 proc 不響應調用方法，則引發 ArgumentError 。