Sha256: 20368e0c22defe8da9c901708b67b54415243a1d393eb6daaf91646946551a90

Contents?: true

Size: 1.29 KB

Versions: 41

Compression:

Stored size: 1.29 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 = {})
  #     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 = keys.map! { |key| convert_key(key) } if respond_to?(:convert_key, true)
    hash = self.class.new
    keys.each { |k| hash[k] = self[k] if has_key?(k) }
    hash
  end

  # Replaces the hash with only the given keys.
  # Returns a hash contained the removed key/value pairs
  #   {:a => 1, :b => 2, :c => 3, :d => 4}.slice!(:a, :b) # => {:c => 3, :d => 4}
  def slice!(*keys)
    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}
  def extract!(*keys)
    result = {}
    keys.each {|key| result[key] = delete(key) }
    result
  end
end

Version data entries

41 entries across 36 versions & 8 rubygems

Version Path
mdg-1.0.1 vendor/bundle/ruby/2.3.0/gems/activesupport-3.2.22.5/lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.22.5 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.22.4 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.22.3 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.22.2 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.22.1 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.22 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.21 lib/active_support/core_ext/hash/slice.rb
apl-library-0.0.90 vendor/bundle/ruby/2.1.0/gems/apl-library-0.0.90/vendor/bundle/ruby/2.1.0/gems/activesupport-3.2.18/lib/active_support/core_ext/hash/slice.rb
apl-library-0.0.90 vendor/bundle/ruby/2.1.0/gems/activesupport-3.2.18/lib/active_support/core_ext/hash/slice.rb
apl-library-0.0.90 vendor/bundle/ruby/2.1.0/gems/apl-library-0.0.90/vendor/bundle/ruby/1.9.1/gems/activesupport-3.2.18/lib/active_support/core_ext/hash/slice.rb
apl-library-0.0.90 vendor/bundle/ruby/1.9.1/gems/activesupport-3.2.18/lib/active_support/core_ext/hash/slice.rb
apl-library-0.0.90 vendor/bundle/ruby/2.1.0/gems/apl-library-0.0.90/vendor/bundle/ruby/1.8/gems/activesupport-3.2.18/lib/active_support/core_ext/hash/slice.rb
apl-library-0.0.90 vendor/bundle/ruby/1.8/gems/activesupport-3.2.18/lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.20 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.19 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.18 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.17 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.16 lib/active_support/core_ext/hash/slice.rb
activesupport-3.2.15 lib/active_support/core_ext/hash/slice.rb