Permalink
Browse files

update Hash documentation with 1.9 syntax [ci skip]

  • Loading branch information...
1 parent ac50b63 commit 29713d7f3bca4267343a0bcaf8f1ee0ea3fe02ae Francesco Rodriguez committed May 27, 2012
Showing with 16 additions and 8 deletions.
  1. +16 −8 activesupport/lib/active_support/core_ext/hash/keys.rb
@@ -1,8 +1,10 @@
class Hash
# Return a new hash with all keys converted using the block operation.
#
- # { :name => 'Rob', :years => '28' }.transform_keys{ |key| key.to_s.upcase }
- # # => { "NAME" => "Rob", "YEARS" => "28" }
+ # hash = { name: 'Rob', age: '28' }
+ #
+ # hash.transform_keys{ |key| key.to_s.upcase }
+ # # => { "NAME" => "Rob", "AGE" => "28" }
def transform_keys
result = {}
keys.each do |key|
@@ -22,8 +24,10 @@ def transform_keys!
# Return a new hash with all keys converted to strings.
#
- # { :name => 'Rob', :years => '28' }.stringify_keys
- # #=> { "name" => "Rob", "years" => "28" }
+ # hash = { name: 'Rob', age: '28' }
+ #
+ # hash.stringify_keys
+ # #=> { "name" => "Rob", "age" => "28" }
def stringify_keys
transform_keys{ |key| key.to_s }
end
@@ -37,8 +41,10 @@ def stringify_keys!
# Return a new hash with all keys converted to symbols, as long as
# they respond to +to_sym+.
#
- # { 'name' => 'Rob', 'years' => '28' }.symbolize_keys
- # #=> { :name => "Rob", :years => "28" }
+ # hash = { 'name' => 'Rob', 'age' => '28' }
+ #
+ # hash.symbolize_keys
+ # #=> { name: "Rob", age: "28" }
def symbolize_keys
transform_keys{ |key| key.to_sym rescue key }
end
@@ -69,8 +75,10 @@ def assert_valid_keys(*valid_keys)
# This includes the keys from the root hash and from all
# nested hashes.
#
- # { :person => { :name => 'Rob', :years => '28' } }.deep_transform_keys{ |key| key.to_s.upcase }
- # # => { "PERSON" => { "NAME" => "Rob", "YEARS" => "28" } }
+ # hash = { person: { name: 'Rob', age: '28' } }
+ #
+ # hash.deep_transform_keys{ |key| key.to_s.upcase }
+ # # => { "PERSON" => { "NAME" => "Rob", "AGE" => "28" } }
def deep_transform_keys(&block)
result = {}
each do |key, value|

0 comments on commit 29713d7

Please sign in to comment.