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
- #reject ⇒ 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
- #select ⇒ 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.
29 30 31 32 33 34 35 36 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 29 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
46 47 48 49 50 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 46 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"
70 71 72 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 70 def []=(key, value) regular_writer(convert_key(key), convert_value(value)) end |
#default(key = nil) ⇒ Object
38 39 40 41 42 43 44 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 38 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.
144 145 146 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 144 def delete(key) super(convert_key(key)) end |
#dup ⇒ Object
Returns an exact copy of the hash.
123 124 125 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 123 def dup HashWithIndifferentAccess.new(self) end |
#extractable_options? ⇒ Boolean
25 26 27 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 25 def true end |
#fetch(key, *extras) ⇒ Object
Fetches the value for the specified key, same as doing hash
107 108 109 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 107 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
98 99 100 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 98 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.
129 130 131 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 129 def merge(hash) self.dup.update(hash) end |
#regular_update ⇒ Object
63 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 63 alias_method :regular_update, :update |
#regular_writer ⇒ Object
62 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 62 alias_method :regular_writer, :[]= |
#reject ⇒ Object
52 53 54 55 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 52 def reject return to_enum(:reject) unless block_given? dup.tap {|hash| hash.reject!{|k, v| yield k, v}} end |
#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.
135 136 137 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 135 def reverse_merge(other_hash) super self.class.(other_hash) end |
#reverse_merge!(other_hash) ⇒ Object
139 140 141 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 139 def reverse_merge!(other_hash) replace(reverse_merge( other_hash )) end |
#select ⇒ Object
57 58 59 60 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 57 def select return to_enum(:select) unless block_given? dup.tap {|hash| hash.reject!{|k, v| ! yield k, v}} end |
#stringify_keys ⇒ Object
149 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 149 def stringify_keys; dup end |
#stringify_keys! ⇒ Object
148 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 148 def stringify_keys!; self end |
#symbolize_keys ⇒ Object
150 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 150 def symbolize_keys; to_hash.symbolize_keys end |
#to_hash ⇒ Object
Convert to a Hash with String keys.
154 155 156 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 154 def to_hash Hash.new(default).merge!(self) end |
#to_options! ⇒ Object
151 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 151 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!"}
84 85 86 87 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 84 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"]
118 119 120 |
# File 'lib/bson/support/hash_with_indifferent_access.rb', line 118 def values_at(*indices) indices.collect {|key| self[convert_key(key)]} end |