W3cubDocs

/Ruby on Rails 6.0

class ActiveSupport::OrderedOptions

Parent:
Hash

Usually key value pairs are handled something like this:

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

Using OrderedOptions, the above code could be reduced to:

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

Public Instance Methods

[](key) Show source
# File activesupport/lib/active_support/ordered_options.rb, line 37
def [](key)
  super(key.to_sym)
end
Calls superclass method
Also aliased as: _get
[]=(key, value) Show source
# File activesupport/lib/active_support/ordered_options.rb, line 33
def []=(key, value)
  super(key.to_sym, value)
end
Calls superclass method
_get(key)
Alias for: []
method_missing(name, *args) Show source
# File activesupport/lib/active_support/ordered_options.rb, line 41
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) Show source
# File activesupport/lib/active_support/ordered_options.rb, line 56
def respond_to_missing?(name, include_private)
  true
end

© 2004–2019 David Heinemeier Hansson
Licensed under the MIT License.