Extended maintenance of Ruby versions 1.8.7 and 1.9.2 will end on July 31, 2014. Read more

In Files

  • optparse.rb

OptionParser::Arguable

Extends command line arguments array (ARGV) to parse itself.

Public Class Methods

extend_object(obj) click to toggle source

Initializes instance variable.

 
               # File optparse.rb, line 1767
def self.extend_object(obj)
  super
  obj.instance_eval {@optparse = nil}
end
            
new(*args) click to toggle source
 
               # File optparse.rb, line 1771
def initialize(*args)
  super
  @optparse = nil
end
            

Public Instance Methods

getopts(*args) click to toggle source

Substitution of getopts is possible as follows. Also see 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
 
               # File optparse.rb, line 1760
def getopts(*args)
  options.getopts(self, *args)
end
            
options() click to toggle source

Actual OptionParser object, automatically created if nonexistent.

If called with a block, yields the OptionParser object and returns the result of the block. If an OptionParser::ParseError exception occurs in the block, it is rescued, a error message printed to STDERR and nil returned.

 
               # File optparse.rb, line 1719
def options
  @optparse ||= OptionParser.new
  @optparse.default_argv = self
  block_given? or return @optparse
  begin
    yield @optparse
  rescue ParseError
    @optparse.warn $!
    nil
  end
end
            
options=(opt) click to toggle source

Sets OptionParser object, when opt is false or nil, methods #options and #options= are undefined. Thus, there is no ways to access the OptionParser object via the receiver object.

 
               # File optparse.rb, line 1702
def options=(opt)
  unless @optparse = opt
    class << self
      undef_method(:options)
      undef_method(:options=)
    end
  end
end
            
order!(&blk) click to toggle source

Parses self destructively in order and returns self containing the rest arguments left unparsed.

 
               # File optparse.rb, line 1735
def order!(&blk) options.order!(self, &blk) end
            
parse!() click to toggle source

Parses self destructively and returns self containing the rest arguments left unparsed.

 
               # File optparse.rb, line 1747
def parse!() options.parse!(self) end
            
permute!() click to toggle source

Parses self destructively in permutation mode and returns self containing the rest arguments left unparsed.

 
               # File optparse.rb, line 1741
def permute!() options.permute!(self) end
            

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.

blog comments powered by Disqus