Ruby 3.4 リファレンスマニュアル

instance method OptionParser#permute!

permute!(argv = self.default_argv, into: nil, exact: self.require_exact) -> [String][permalink][rdoc][edit]

与えられた argv を破壊的にパースします。argv からオプションがすべて取り除かれます。オプションではないコマンドの引数(下の例で言うと somefile)があってもパースを中断しません。 argv を返します。

下の例で言うと、order と違いコマンドの引数 somefile よりも後ろにオプションを置くことができます。

into と exact 以外のキーワード引数を渡しても無視されます(ArgumentError は発生しません)。

[PARAM] argv:
パースしたい引数を文字列の配列で指定します。
[PARAM] into:
オプションを格納するハッシュを指定します。指定したハッシュにはオプションの名前をキーとして、OptionParser#onに渡されたブロックの値が格納されます。キーの名前はロングオプションが定義されていればロングオプションの値を、ショートオプションのみの場合はショートオプションの値から、先頭の "-" を除いてシンボル化した値が使用されます。
[PARAM] exact:
真を指定すると、ロングオプションを省略した形(OptionParser#require_exact を参照)を受け付けなくなります。省略時は OptionParser#require_exact の値です。
[EXCEPTION] OptionParser::ParseError:
パースに失敗した場合、発生します。実際は OptionParser::ParseError のサブクラスになります。
opt.rb
require 'optparse'
opt = OptionParser.new

opt.on('-a [VAL]') {|v| p :a }
opt.on('-b ') {|v| p :b }

opt.permute!(ARGV)
p ARGV

↓

$ ruby opt.rb -a foo somefile -b
:a
:b
["somefile"]