Sha256: 44d8306d9ada5105257fc18ea59dad514d464e23be3d79cae8e3aded0edb5a9c

Contents?: true

Size: 1.36 KB

Versions: 26

Compression:

Stored size: 1.36 KB

Contents

class Hash
  # Slice a hash to include only the given keys. This is useful for
  # limiting an options hash to valid keys before passing to a method:
  #
  #   def search(criteria = {})
  #     criteria.assert_valid_keys(:mass, :velocity, :time)
  #   end
  #
  #   search(options.slice(:mass, :velocity, :time))
  #
  # If you have an array of keys you want to limit to, you should splat them:
  #
  #   valid_keys = [:mass, :velocity, :time]
  #   search(options.slice(*valid_keys))
  def slice(*keys)
    keys.map! { |key| convert_key(key) } if respond_to?(:convert_key, true)
    keys.each_with_object(self.class.new) { |k, hash| hash[k] = self[k] if has_key?(k) }
  end

  # Replaces the hash with only the given keys.
  # Returns a hash containing the removed key/value pairs.
  #
  #   { a: 1, b: 2, c: 3, d: 4 }.slice!(:a, :b)
  #   # => {:c=>3, :d=>4}
  def slice!(*keys)
    keys.map! { |key| convert_key(key) } if respond_to?(:convert_key, true)
    omit = slice(*self.keys - keys)
    hash = slice(*keys)
    replace(hash)
    omit
  end

  # Removes and returns the key/value pairs matching the given keys.
  #
  #   { a: 1, b: 2, c: 3, d: 4 }.extract!(:a, :b) # => {:a=>1, :b=>2}
  #   { a: 1, b: 2 }.extract!(:a, :x)             # => {:a=>1}
  def extract!(*keys)
    keys.each_with_object(self.class.new) { |key, result| result[key] = delete(key) if has_key?(key) }
  end
end

Version data entries

26 entries across 26 versions & 4 rubygems

Version Path
motion-support-1.2.1 motion/core_ext/hash/slice.rb
motion-support-1.1.1 motion/core_ext/hash/slice.rb
motion-support-1.2.0 motion/core_ext/hash/slice.rb
motion-support-1.1.0 motion/core_ext/hash/slice.rb
motion-support-1.0.0 motion/core_ext/hash/slice.rb
motion-support-0.3.0 motion/core_ext/hash/slice.rb
motion_blender-support-0.2.8 motion/core_ext/hash/slice.rb
motion_blender-support-0.2.7 motion/core_ext/hash/slice.rb
activesupport-4.0.3 lib/active_support/core_ext/hash/slice.rb
motion-support-0.2.6 motion/core_ext/hash/slice.rb
activesupport-4.0.2 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.1 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.1.rc4 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.1.rc3 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.1.rc2 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.1.rc1 lib/active_support/core_ext/hash/slice.rb
motion-support-0.2.5 motion/core_ext/hash/slice.rb
challah-1.0.0 vendor/bundle/gems/activesupport-4.0.0/lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.0 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.0.rc2 lib/active_support/core_ext/hash/slice.rb