Sha256: 2b199f185e72398d16d50763627301e0127444b1af50561041667a685ba05615

Contents?: true

Size: 1.44 KB

Versions: 121

Compression:

Stored size: 1.44 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)
    hash.default      = default
    hash.default_proc = default_proc if default_proc
    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

121 entries across 121 versions & 8 rubygems

Version Path
dummer-0.4.0 lib/ext/hash/slice.rb
cmis-ruby-0.5.22 lib/ext/hash/slice.rb
cmis-ruby-0.5.21 lib/ext/hash/slice.rb
activesupport-4.1.12 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.12.rc1 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.11 lib/active_support/core_ext/hash/slice.rb
cmis-ruby-0.5.20 lib/ext/hash/slice.rb
cmis-ruby-0.5.19 lib/ext/hash/slice.rb
activesupport-4.1.10 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.10.rc4 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.10.rc3 lib/active_support/core_ext/hash/slice.rb
cmis-ruby-0.5.18 lib/ext/hash/slice.rb
activesupport-4.1.10.rc2 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.10.rc1 lib/active_support/core_ext/hash/slice.rb
cmis-ruby-0.5.17 lib/ext/hash/slice.rb
activesupport-4.0.13 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.9 lib/active_support/core_ext/hash/slice.rb
activesupport-4.1.9.rc1 lib/active_support/core_ext/hash/slice.rb
activesupport-4.0.13.rc1 lib/active_support/core_ext/hash/slice.rb
cmis-ruby-0.5.16 lib/ext/hash/slice.rb