Sha256: 277766212d61a84725f0b426ae1ca31dbf84b9f4afb4165f402ab844c9e268a4

Contents?: true

Size: 1.48 KB

Versions: 48

Compression:

Stored size: 1.48 KB

Contents

# frozen_string_literal: true

class Hash
  # Slices a hash to include only the given keys. Returns a hash containing
  # the given keys.
  #
  #   { a: 1, b: 2, c: 3, d: 4 }.slice(:a, :b)
  #   # => {:a=>1, :b=>2}
  #
  # 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.each_with_object(Hash.new) { |k, hash| hash[k] = self[k] if has_key?(k) }
  end unless method_defined?(:slice)

  # 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)
    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

48 entries across 48 versions & 7 rubygems

Version Path
activesupport-5.2.8.1 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.8 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.7.1 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.7 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.6.3 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.6.2 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.6.1 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.6 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.6 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.5 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.5 lib/active_support/core_ext/hash/slice.rb
grape-extra_validators-2.0.0 vendor/bundle/ruby/2.6.0/gems/activesupport-5.2.4.1/lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.4 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.3 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.2 lib/active_support/core_ext/hash/slice.rb
grape-extra_validators-1.0.0 vendor/bundle/ruby/2.4.0/gems/activesupport-5.2.4.1/lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.1 lib/active_support/core_ext/hash/slice.rb
zuora_connect_ui-0.10.0 vendor/ruby/2.6.0/gems/activesupport-5.2.3/lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4 lib/active_support/core_ext/hash/slice.rb
activesupport-5.2.4.rc1 lib/active_support/core_ext/hash/slice.rb