在讨论OptionParser特性的文章中，我们讨论了在Ruby中使用OptionParser比手动查看ARGV来手动解析命令更可取的一些原因。现在是开始学习如何使用OptionParser及其特性的时候了。

以下样板代码将用于本教程中的所有示例。要尝试任何示例，只需将示例的opts.on块放在TODO注释旁边。运行该程序将打印选项has和ARGV的状态，允许您检查开关的效果。

#!/usr/bin/env ruby require 'optparse' require 'pp' # This hash will hold all of the options # parsed from the command-line by # OptionParser. options = {} optparse = OptionParser.new do|opts| # TODO: Put command-line options here # This displays the help screen, all programs are # assumed to have this option. opts.on( '-h', '--help', 'Display this screen' ) do puts opts exit end end # Parse the command-line. Remember there are two forms # of the parse method. The 'parse' method simply parses # ARGV, while the 'parse!' method parses ARGV and removes # any options found there, as well as any parameters for # the options. What's left is the list of files to resize. optparse.parse! pp "Options:", options pp "ARGV:", ARGV

简单开关

简单开关是一个没有可选形式或参数的参数。其效果是只需在选项散列中设置一个标志。不会将其他参数传递给on方法。

options[:simple] = false opts.on( '-s', '--simple', "Simple argument" ) do options[:simple] = true end

带强制参数的开关

接受参数的开关只需要以开关的长格式声明参数名称。例如，“-f”、“--file file”表示-f或--file开关接受一个名为file的参数，并且该参数是必需的。如果不向-f或--file传递参数，则不能使用它们。

options[:mand] = "" opts.on( '-m', '--mandatory FILE', "Mandatory argument" ) do|f| options[:mand] = f end

带可选参数的开关

开关参数不必是强制性的，它们可以是可选的。若要声明开关参数为可选参数，请将其名称放在开关说明的括号中。例如，“--logfile[FILE]”表示FILE参数是可选的。如果未提供，程序将假定一个正常的默认值，例如一个名为log.txt的文件。

在这个例子中，使用了成语a=b | | c。这只是“a=b”的简写，但如果b为false或nil，则a=c。

options[:opt] = false opts.on( '-o', '--optional [OPT]', "Optional argument" ) do|f| options[:opt] = f || "nothing" end

自动转换为浮点

OptionParser可以自动将参数转换为某些类型。其中一种类型是Float。要将参数自动转换为开关到Float，请在开关描述字符串之后将Float传递给on方法。

自动转换很方便。它们不仅可以为您节省将字符串转换为所需类型的步骤，还可以为您检查格式，如果格式不正确，将引发异常。

options[:float] = 0.0 opts.on( '-f', '--float NUM', Float, "Convert to float" ) do|f| options[:float] = f end

OptionParser可以自动转换为的其他一些类型包括时间和整数。

参数列表

参数可以解释为列表。这可以看作是转换为数组，就像转换为Float一样。虽然您的选项字符串可以定义名为“a、b、c”的参数，但OptionParser将盲目地允许列表中任意数量的元素。因此，如果需要特定数量的元素，请确保自己检查数组长度。

options[:list] = [] opts.on( '-l', '--list a,b,c', Array, "List of parameters" ) do|l| options[:list] = l end

参数集

有时，将参数限制为切换到几个选项是有意义的。例如，下面的开关将只接受一个强制参数，该参数必须是yes、no或maybe中的一个。如果该参数是任何其他参数，将引发异常。

为此，请将可接受参数列表作为符号传递到开关描述字符串之后。

options[:set] = :yes opts.on( '-s', '--set OPT', [:yes, :no, :maybe], "Parameters from a set" ) do|s| options[:set] = s end

否定形式的

开关可以具有否定形式。开关--negated可以有一个产生相反效果的开关，称为--no negated。要在开关描述字符串中对此进行描述，请将替代部分放在括号中：--[no-]negated。如果遇到第一个表单，则会将true传递给块，如果遇到第二个表单，则会阻止false。

options[:neg] = false opts.on( '-n', '--[no-]negated', "Negated forms" ) do|n| options[:neg] = n end