Skip to Content Skip to Search

OrderedOptions inherits from Hash and provides dynamic accessor methods.

With a Hash, key-value pairs are typically managed like this:

h = {}
h[:boy] = 'John'
h[:girl] = 'Mary'
h[:boy]  # => 'John'
h[:girl] # => 'Mary'
h[:dog]  # => nil

Using OrderedOptions, the above code can be written as:

h = ActiveSupport::OrderedOptions.new
h.boy = 'John'
h.girl = 'Mary'
h.boy  # => 'John'
h.girl # => 'Mary'
h.dog  # => nil

To raise an exception when the value is blank, append a bang to the key name, like:

h.dog! # => raises KeyError: :dog is blank
Methods
#
E
I
M
R

Instance Public methods

[](key)

Also aliased as: _get
# File activesupport/lib/active_support/ordered_options.rb, line 39
def [](key)
  super(key.to_sym)
end

[]=(key, value)

# File activesupport/lib/active_support/ordered_options.rb, line 35
def []=(key, value)
  super(key.to_sym, value)
end

_get(key)

Alias for: []

extractable_options?()

# File activesupport/lib/active_support/ordered_options.rb, line 62
def extractable_options?
  true
end

inspect()

# File activesupport/lib/active_support/ordered_options.rb, line 66
def inspect
  "#<#{self.class.name} #{super}>"
end

method_missing(name, *args)

# File activesupport/lib/active_support/ordered_options.rb, line 43
def method_missing(name, *args)
  name_string = +name.to_s
  if name_string.chomp!("=")
    self[name_string] = args.first
  else
    bangs = name_string.chomp!("!")

    if bangs
      self[name_string].presence || raise(KeyError.new(":#{name_string} is blank"))
    else
      self[name_string]
    end
  end
end

respond_to_missing?(name, include_private)

# File activesupport/lib/active_support/ordered_options.rb, line 58
def respond_to_missing?(name, include_private)
  true
end