Class: Mash
Overview
Instance Method Summary collapse
- #[]=(key, value) ⇒ Object
- #default(key = nil) ⇒ Object
- #delete(key) ⇒ Object
-
#except(*keys) ⇒ Mash
A new mash without the selected keys.
-
#fetch(key, *extras) ⇒ Object
The value at key or the default value.
-
#initialize(constructor = {}) ⇒ Mash
constructor
A new instance of Mash.
-
#key?(key) ⇒ Boolean
(also: #include?, #has_key?, #member?)
True if the key exists in the mash.
-
#merge(hash) ⇒ Mash
A new mash with the hash values merged in.
- #regular_update ⇒ Object
- #regular_writer ⇒ Object
-
#stringify_keys! ⇒ Mash
Used to provide the same interface as Hash.
-
#symbolize_keys ⇒ Hash
The mash as a Hash with symbolized keys.
-
#to_hash ⇒ Hash
The mash as a Hash with string keys.
-
#update(other_hash) ⇒ Mash
(also: #merge!)
The updated mash.
-
#values_at(*indices) ⇒ Array
The values at each of the provided keys.
Methods inherited from Hash
#add_html_class!, #environmentize_keys!, from_xml, #normalize_param, #only, #protect_keys!, #to_mash, #to_params, #to_xml_attributes, #unprotect_keys!
Constructor Details
Instance Method Details
#[]=(key, value) ⇒ Object
44 45 46 |
# File 'lib/extlib/mash.rb', line 44 def []=(key, value) regular_writer(convert_key(key), convert_value(value)) end |
#default(key = nil) ⇒ Object
27 28 29 30 31 32 33 |
# File 'lib/extlib/mash.rb', line 27 def default(key = nil) if key.is_a?(Symbol) && include?(key = key.to_s) self[key] else super end end |
#delete(key) ⇒ Object
97 98 99 |
# File 'lib/extlib/mash.rb', line 97 def delete(key) super(convert_key(key)) end |
#except(*keys) ⇒ Mash
Returns A new mash without the selected keys.
108 109 110 |
# File 'lib/extlib/mash.rb', line 108 def except(*keys) super(*keys.map {|k| convert_key(k)}) end |
#fetch(key, *extras) ⇒ Object
Returns The value at key or the default value.
76 77 78 |
# File 'lib/extlib/mash.rb', line 76 def fetch(key, *extras) super(convert_key(key), *extras) end |
#key?(key) ⇒ Boolean Also known as: include?, has_key?, member?
Returns True if the key exists in the mash.
63 64 65 |
# File 'lib/extlib/mash.rb', line 63 def key?(key) super(convert_key(key)) end |
#merge(hash) ⇒ Mash
Returns A new mash with the hash values merged in.
91 92 93 |
# File 'lib/extlib/mash.rb', line 91 def merge(hash) self.dup.update(hash) end |
#regular_update ⇒ Object
36 |
# File 'lib/extlib/mash.rb', line 36 alias_method :regular_update, :update |
#regular_writer ⇒ Object
35 |
# File 'lib/extlib/mash.rb', line 35 alias_method :regular_writer, :[]= |
#stringify_keys! ⇒ Mash
Used to provide the same interface as Hash.
115 |
# File 'lib/extlib/mash.rb', line 115 def stringify_keys!; self end |
#symbolize_keys ⇒ Hash
Returns The mash as a Hash with symbolized keys.
118 119 120 121 122 |
# File 'lib/extlib/mash.rb', line 118 def symbolize_keys h = Hash.new(default) each { |key, val| h[key.to_sym] = val } h end |
#to_hash ⇒ Hash
Returns The mash as a Hash with string keys.
125 126 127 |
# File 'lib/extlib/mash.rb', line 125 def to_hash Hash.new(default).merge(self) end |
#update(other_hash) ⇒ Mash Also known as: merge!
Returns The updated mash.
53 54 55 56 |
# File 'lib/extlib/mash.rb', line 53 def update(other_hash) other_hash.each_pair { |key, value| regular_writer(convert_key(key), convert_value(value)) } self end |
#values_at(*indices) ⇒ Array
Returns The values at each of the provided keys.
84 85 86 |
# File 'lib/extlib/mash.rb', line 84 def values_at(*indices) indices.collect {|key| self[convert_key(key)]} end |