Object::HashWithIndifferentAccess (original) (raw)

Methods

• []=

C

• convert_key,
• convert_value

D

• default,
• delete,
• dup

E

• extractable_options?

F

• fetch

H

• has_key?

I

• include?

K

• key?

M

• member?,
• merge,
• merge!

N

• new,
• new_from_hash_copying_default

R

• regular_update,
• regular_writer,
• reverse_merge,
• reverse_merge!

S

• store,
• stringify_keys,
• stringify_keys!,
• symbolize_keys

T

• to_hash,
• to_options!

U

• update

V

• values_at

W

• with_indifferent_access

Class Public methods

new(constructor = {})

Source: show

def initialize(constructor = {}) if constructor.is_a?(Hash) super() update(constructor) else super(constructor) end end

new_from_hash_copying_default(hash)

Source: show

def self.new_from_hash_copying_default(hash) new(hash).tap do |new_hash| new_hash.default = hash.default end end

Instance Public methods

[]=(key, value)

Assigns a new value to the hash:

hash = HashWithIndifferentAccess.new hash[:key] = "value"

Source: show

def []=(key, value) regular_writer(convert_key(key), convert_value(value)) end

default(key = nil)

Source: show

def default(key = nil) if key.is_a?(Symbol) && include?(key = key.to_s) self[key] else super end end

delete(key)

Removes a specified key from the hash.

Source: show

def delete(key) super(convert_key(key)) end

dup()

Returns an exact copy of the hash.

Source: show

def dup self.class.new(self).tap do |new_hash| new_hash.default = default end end

Always returns true, so that Array#extract_options! finds members of this class.

fetch(key, *extras)

Fetches the value for the specified key, same as doing hash

Source: show

def fetch(key, *extras) super(convert_key(key), *extras) end

key?(key)

Checks the hash for a key matching the argument passed in:

hash = HashWithIndifferentAccess.new hash["key"] = "value" hash.key? :key
hash.key? "key"

Source: show

def key?(key) super(convert_key(key)) end

merge(hash)

Merges the instantized and the specified hashes together, giving precedence to the values from the second hash Does not overwrite the existing hash.

Source: show

def merge(hash) self.dup.update(hash) end

regular_update(other_hash)

regular_writer(key, value)

reverse_merge(other_hash)

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_mergeis called on a HashWithDifferentAccess.

Source: show

def reverse_merge(other_hash) super self.class.new_from_hash_copying_default(other_hash) end

reverse_merge!(other_hash)

Source: show

def reverse_merge!(other_hash) replace(reverse_merge( other_hash )) end

stringify_keys()

Source: show

def stringify_keys; dup end

stringify_keys!()

Source: show

def stringify_keys!; self end

symbolize_keys()

Source: show

def symbolize_keys; to_hash.symbolize_keys end

to_hash()

Source: show

def to_hash Hash.new(default).merge!(self) end

to_options!()

Source: show

def to_options!; self end

update(other_hash)

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)

Source: show

def update(other_hash) if other_hash.is_a? HashWithIndifferentAccess super(other_hash) else other_hash.each_pair { |key, value| regular_writer(convert_key(key), convert_value(value)) } self end end

values_at(*indices)

Returns an array of the values at the specified indices:

hash = HashWithIndifferentAccess.new hash[:a] = "x" hash[:b] = "y" hash.values_at("a", "b")

Source: show

def values_at(*indices) indices.collect {|key| self[convert_key(key)]} end

with_indifferent_access()

Source: show

def with_indifferent_access dup end

Instance Protected methods

convert_key(key)

Source: show

def convert_key(key) key.kind_of?(Symbol) ? key.to_s : key end

convert_value(value)

Source: show

def convert_value(value) if value.is_a? Hash value.nested_under_indifferent_access elsif value.is_a?(Array) value.dup.replace(value.map { |e| convert_value(e) }) else value end end