class Mail::IndifferentHash
Public Class Methods
Source
# File lib/mail/indifferent_hash.rb, line 10 def initialize(constructor = {}) if constructor.is_a?(Hash) super() update(constructor) else super(constructor) end end
Calls superclass method
Source
# File lib/mail/indifferent_hash.rb, line 27 def self.new_from_hash_copying_default(hash) IndifferentHash.new(hash).tap do |new_hash| new_hash.default = hash.default end end
Public Instance Methods
Source
# File lib/mail/indifferent_hash.rb, line 41 def []=(key, value) regular_writer(convert_key(key), convert_value(value)) end
Assigns a new value to the hash:
hash = HashWithIndifferentAccess.new hash[:key] = "value"
Also aliased as: regular_writer, store
Source
# File lib/mail/indifferent_hash.rb, line 19 def default(key = nil) if key.is_a?(Symbol) && include?(key = key.to_s) self[key] else super end end
Calls superclass method
Source
# File lib/mail/indifferent_hash.rb, line 117 def delete(key) super(convert_key(key)) end
Removes a specified key from the hash.
Calls superclass method
Source
# File lib/mail/indifferent_hash.rb, line 96 def dup IndifferentHash.new(self) end
Returns an exact copy of the hash.
Source
# File lib/mail/indifferent_hash.rb, line 80 def fetch(key, *extras) super(convert_key(key), *extras) end
Fetches the value for the specified key, same as doing hash
Calls superclass method
Source
# File lib/mail/indifferent_hash.rb, line 71 def key?(key) super(convert_key(key)) end
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
Calls superclass method
Source
# File lib/mail/indifferent_hash.rb, line 102 def merge(hash) self.dup.update(hash) end
Merges the instantized and the specified hashes together, giving precedence to the values from the second hash Does not overwrite the existing hash.
Source
# File lib/mail/indifferent_hash.rb, line 108 def reverse_merge(other_hash) super self.class.new_from_hash_copying_default(other_hash) end
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.
Calls superclass method
Source
# File lib/mail/indifferent_hash.rb, line 112 def reverse_merge!(other_hash) replace(reverse_merge( other_hash )) end
Source
# File lib/mail/indifferent_hash.rb, line 121 def stringify_keys!; self end
Source
# File lib/mail/indifferent_hash.rb, line 123 def symbolize_keys; to_hash.symbolize_keys end
Source
# File lib/mail/indifferent_hash.rb, line 126 def to_hash Hash.new(default).merge!(self) end
Source
# File lib/mail/indifferent_hash.rb, line 57 def update(other_hash) other_hash.each_pair { |key, value| regular_writer(convert_key(key), convert_value(value)) } self end
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!"}
Also aliased as: regular_update, merge!
Source
# File lib/mail/indifferent_hash.rb, line 91 def values_at(*indices) indices.collect {|key| self[convert_key(key)]} end
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"]
Protected Instance Methods
Source
# File lib/mail/indifferent_hash.rb, line 132 def convert_key(key) key.kind_of?(Symbol) ? key.to_s : key end
Source
# File lib/mail/indifferent_hash.rb, line 136 def convert_value(value) if value.class == Hash self.class.new_from_hash_copying_default(value) elsif value.is_a?(Array) value.dup.replace(value.map { |e| convert_value(e) }) else value end end