模块 OptionParser::Arguable

扩展命令行参数数组 (ARGV) 以解析自身。

公共类方法

源代码

# File lib/optparse.rb, line 2403
def self.extend_object(obj)
  super
  obj.instance_eval {@optparse = nil}
end

初始化实例变量。

调用父类方法

公共实例方法

getopts (*args, symbolize_names: false, **keywords)

源代码

# File lib/optparse.rb, line 2396
def getopts(*args, symbolize_names: false, **keywords)
  options.getopts(self, *args, symbolize_names: symbolize_names, **keywords)
end

可以使用以下方式替换 getopts。另请参阅 OptionParser#getopts。

def getopts(*args)
  ($OPT = ARGV.getopts(*args)).each do |opt, val|
    eval "$OPT_#{opt.gsub(/[^A-Za-z0-9_]/, '_')} = val"
  end
rescue OptionParser::ParseError
end

options () { |optparse| ... }

源代码

# File lib/optparse.rb, line 2355
def options
  @optparse ||= OptionParser.new
  @optparse.default_argv = self
  block_given? or return @optparse
  begin
    yield @optparse
  rescue ParseError
    @optparse.warn $!
    nil
  end
end

实际的 OptionParser 对象，如果不存在则自动创建。

如果使用块调用，则会产生 OptionParser 对象并返回块的结果。如果在块中发生 OptionParser::ParseError 异常，则会捕获该异常，将错误消息打印到 STDERR 并返回 nil。

options= (opt)

源代码

# File lib/optparse.rb, line 2338
def options=(opt)
  unless @optparse = opt
    class << self
      undef_method(:options)
      undef_method(:options=)
    end
  end
end

设置 OptionParser 对象，当 opt 为 false 或 nil 时，方法 OptionParser::Arguable#options 和 OptionParser::Arguable#options= 将变为未定义。因此，没有办法通过接收器对象访问 OptionParser 对象。

order! (**keywords, &blk)

源代码

# File lib/optparse.rb, line 2371
def order!(**keywords, &blk) options.order!(self, **keywords, &blk) end

按顺序破坏性地解析 self，并返回包含未解析剩余参数的 self。

parse! (**keywords)

源代码

# File lib/optparse.rb, line 2383
def parse!(**keywords) options.parse!(self, **keywords) end

破坏性地解析 self，并返回包含未解析剩余参数的 self。

permute! (**keywords)

源代码

# File lib/optparse.rb, line 2377
def permute!(**keywords) options.permute!(self, **keywords) end

以置换模式破坏性地解析 self，并返回包含未解析剩余参数的 self。