Class: ActiveSupport::HashWithIndifferentAccess
- Inherits:
-
Hash
- Object
- Hash
- ActiveSupport::HashWithIndifferentAccess
- Defined in:
- lib/bson/support/hash_with_indifferent_access.rb
Class Method Summary collapse
Instance Method Summary collapse
-
#[]=(key, value) ⇒ Object
Assigns a new value to the hash:.
- #default(key = nil) ⇒ Object
-
#delete(key) ⇒ Object
Removes a specified key from the hash.
-
#dup ⇒ Object
Returns an exact copy of the hash.
- #extractable_options? ⇒ Boolean
-
#fetch(key, *extras) ⇒ Object
Fetches the value for the specified key, same as doing hash.
-
#initialize(constructor = {}) ⇒ HashWithIndifferentAccess
constructor
A new instance of HashWithIndifferentAccess.
-
#key?(key) ⇒ Boolean
(also: #include?, #has_key?, #member?)
Checks the hash for a key matching the argument passed in:.
-
#merge(hash) ⇒ Object
Merges the instantized and the specified hashes together, giving precedence to the values from the second hash Does not overwrite the existing hash.
- #regular_update ⇒ Object
- #regular_writer ⇒ Object
-
#reverse_merge(other_hash) ⇒ Object
Performs the opposite of merge, with the keys and values from the first hash taking precedence over the second.
- #reverse_merge!(other_hash) ⇒ Object
- #stringify_keys ⇒ Object
- #stringify_keys! ⇒ Object
- #symbolize_keys ⇒ Object
-
#to_hash ⇒ Object
Convert to a Hash with String keys.
- #to_options! ⇒ Object
-
#update(other_hash) ⇒ Object
(also: #merge!)
Updates the instantized hash with values from the second:.
-
#values_at(*indices) ⇒ Object
Returns an array of the values at the specified indices:.
Constructor Details
#initialize(constructor = {}) ⇒ HashWithIndifferentAccess
Returns a new instance of HashWithIndifferentAccess.
33 34 35 36 37 38 39 40 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 33 def initialize(constructor = {}) if constructor.is_a?(Hash) super() update(constructor) else super(constructor) end end |
Class Method Details
.new_from_hash_copying_default(hash) ⇒ Object
50 51 52 53 54 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 50 def self.(hash) ActiveSupport::HashWithIndifferentAccess.new(hash).tap do |new_hash| new_hash.default = hash.default end end |
Instance Method Details
#[]=(key, value) ⇒ Object
Assigns a new value to the hash:
hash = HashWithIndifferentAccess.new
hash[:key] = "value"
64 65 66 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 64 def []=(key, value) regular_writer(convert_key(key), convert_value(value)) end |
#default(key = nil) ⇒ Object
42 43 44 45 46 47 48 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 42 def default(key = nil) if key.is_a?(Symbol) && include?(key = key.to_s) self[key] else super end end |
#delete(key) ⇒ Object
Removes a specified key from the hash.
138 139 140 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 138 def delete(key) super(convert_key(key)) end |
#dup ⇒ Object
Returns an exact copy of the hash.
117 118 119 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 117 def dup HashWithIndifferentAccess.new(self) end |
#extractable_options? ⇒ Boolean
29 30 31 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 29 def true end |
#fetch(key, *extras) ⇒ Object
Fetches the value for the specified key, same as doing hash
101 102 103 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 101 def fetch(key, *extras) super(convert_key(key), *extras) end |
#key?(key) ⇒ Boolean Also known as: include?, has_key?, member?
Checks the hash for a key matching the argument passed in:
hash = HashWithIndifferentAccess.new
hash["key"] = "value"
hash.key? :key # => true
hash.key? "key" # => true
92 93 94 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 92 def key?(key) super(convert_key(key)) end |
#merge(hash) ⇒ Object
Merges the instantized and the specified hashes together, giving precedence to the values from the second hash Does not overwrite the existing hash.
123 124 125 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 123 def merge(hash) self.dup.update(hash) end |
#regular_update ⇒ Object
57 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 57 alias_method :regular_update, :update |
#regular_writer ⇒ Object
56 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 56 alias_method :regular_writer, :[]= |
#reverse_merge(other_hash) ⇒ Object
Performs the opposite of merge, with the keys and values from the first hash taking precedence over the second. This overloaded definition prevents returning a regular hash, if reverse_merge is called on a HashWithDifferentAccess.
129 130 131 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 129 def reverse_merge(other_hash) super self.class.(other_hash) end |
#reverse_merge!(other_hash) ⇒ Object
133 134 135 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 133 def reverse_merge!(other_hash) replace(reverse_merge( other_hash )) end |
#stringify_keys ⇒ Object
143 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 143 def stringify_keys; dup end |
#stringify_keys! ⇒ Object
142 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 142 def stringify_keys!; self end |
#symbolize_keys ⇒ Object
144 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 144 def symbolize_keys; to_hash.symbolize_keys end |
#to_hash ⇒ Object
Convert to a Hash with String keys.
148 149 150 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 148 def to_hash Hash.new(default).merge!(self) end |
#to_options! ⇒ Object
145 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 145 def ; self end |
#update(other_hash) ⇒ Object Also known as: merge!
Updates the instantized hash with values from the second:
hash_1 = HashWithIndifferentAccess.new
hash_1[:key] = "value"
hash_2 = HashWithIndifferentAccess.new
hash_2[:key] = "New Value!"
hash_1.update(hash_2) # => {"key"=>"New Value!"}
78 79 80 81 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 78 def update(other_hash) other_hash.each_pair { |key, value| regular_writer(convert_key(key), convert_value(value)) } self end |
#values_at(*indices) ⇒ Object
Returns an array of the values at the specified indices:
hash = HashWithIndifferentAccess.new
hash[:a] = "x"
hash[:b] = "y"
hash.values_at("a", "b") # => ["x", "y"]
112 113 114 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 112 def values_at(*indices) indices.collect {|key| self[convert_key(key)]} end |