Level Up Your Ruby Skillz: Working With Hashes
Tags: ruby, beginners, tips, tutorial
Published: 2019-05-15 12:06:48

---
title: Level Up Your Ruby Skillz: Working With Hashes
published: true
description: A guide to some of the most useful methods for working with hashes in Ruby. 
tags: ruby, beginners, tips, tutorial 
cover_image: https://thepracticaldev.s3.amazonaws.com/i/mzw3m333dkffu4jovm3v.png
series: Level Up Your Ruby Skillz
---

Last week I tackled Ruby arrays and shared some of the methods I find the most useful for working with them. This week I want to talk about HASHES! Before I dive head first into my favorite methods, I want to give a quick summary of what a hash is in Ruby and how it works. The definition of a [Hash](https://ruby-doc.org/core-2.6.0.preview2/Hash.html) straight from the docs themselves:

> A Hash is a dictionary-like collection(If you are a Java person, think maps) of unique keys and their values. Also called associative arrays(honestly, I have never heard this before but 🤷), they are similar to Arrays, but where an Array uses integers as its index, a Hash allows you to use any object type.

One of the keys(pun intended 😉) in that definition is that a Hash allows you to use any object type as your index. Most people when they think of a Hash think of this.
```ruby
{ a: 1, b: 2, c: 3 }
```
But hashes can be so much more in Ruby! For example, all of these are Hashes.
```ruby
# String Keys
{ "a" => 1, "b" => 2, "c" => 3 }

# Integer Keys 
{ 1 => "a", 2 => "b", 3 => "c" } 

# Symbol Keys (Hashrocket notation) 
{ :a => 1, :b => 2, :c => 3 } 

# Array Keys
{ ['a'] => 1, ['b'] => 2, ['c'] => 3 } 

# Hash Keys 
{ { :a => 1 } => 2, { :b => 2 } => 3 } 
```
Any object type your heart desires can be a Hash key. Now that we have the semantics and the definition down, let's get to the methods!

* [`each`](#each)
* [`each_key`](#each_key_value)/[`each_value`](#each_key_value)
* [`keys`](#keys_values) / [`values`](#keys_values)
* [`key?`](#key_value?)/[`value?`](#key_value?)
* [`transform_keys`](#transform_keys)/ [`transform_values`](#transform_values)
* [`dig`](#dig)
* [`fetch`](#fetch)
* [`select`](#select)
* [`reject`](#reject)
* [`slice`](#slice)
* [`chaining`](#chaining)

NOTE: Just like in the [array tutorial](https://dev.to/molly_struve/level-up-your-ruby-skillz-working-with-arrays-hnn), if you see `irb` in the code snippets that means I am working in a Ruby console. Also, I made a code [CHEAT SHEET](https://paper.dropbox.com/doc/Handy-Ruby-Hash-Methods--AdDf0Q90cMJJ8Xos__W_Un09AQ-vXrU498IlJByJtgHG9o6f) if you want the code without all the explanations.

<a name="each"></a>
# [`each`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-each)

One of the most valuable things you can do with a hash is iterate over it. One of the easiest ways to loop over a hash is to use [`each`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-each). I don't know about you, but when I started out using Ruby, my hash `each` statements looked like this.
```
irb> { a: 1, b: 2, c: 3 }.each do |pair|
  puts "#{pair.first} #{pair.last}"
end
a 1
b 2
c 3
=> {:a=>1, :b=>2, :c=>3}
```
Here, I am executing my `each` method the same way I did for my arrays. The difference now is that `pair` is an array itself. The first element is my key and the second element is my value. **NOTE: After executing the block for each of our key/value pairs, the original hash that we iterated over is returned.** 

The above way works, but there is an even slicker way, you can separate that pair by passing two arguments to your block. This means you can rewrite the above like this:
```
irb> { a: 1, b: 2, c: 3 }.each do |key, value|
  puts "#{key} #{value}"
end
a 1
b 2
c 3
=> {:a=>1, :b=>2, :c=>3}
```
Now we have two separate variables, one representing the key and one representing the value. 

<a name="each_key_value"></a>
# [`each_key`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-each_key)/[`each_value`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-each_value)
But what if we don't want all the keys and values? What if we just want the keys or just want the values? There are methods for each of those! 
```
irb> { a: 1, b: 2, c: 3 }.each_key do |key|
  puts key
end
a
b 
c
=> {:a=>1, :b=>2, :c=>3}

irb> { a: 1, b: 2, c: 3 }.each_value do |value|
  puts value
end
1
2 
3
=> {:a=>1, :b=>2, :c=>3}
```
Notice, that once again, regardless if we use `each_key` or `each_value`, we still get the original hash back after we are done iterating over it. 

<a name="keys_values"></a>
# [`keys`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-keys)/ [`values`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-values)
Let's say you just want an array of the keys or you just want an array of the values from a hash. To do this, you can use `keys` or `values`. Both will return an array of the keys or values for a given hash. 
```
irb> { a: 1, b: 2, c: 3 }.keys 
=> [:a, :b, :c]
irb> { a: 1, b: 2, c: 3 }.values 
=> [1, 2, 3]
```

<a name="key_value?"></a>
# [`key?`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-key-3F)/ [`value?`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-value-3F)
Another couple of pretty straight forward methods are the key and value [predicates](http://ruby-for-beginners.rubymonstas.org/objects/predicates.html). If you want to know if a key or a value exists in a Hash then you can use `key?` or `value?`. 
```
irb> { a: 1, b: 2 }.key?(:b)
=> true
irb> { a: 1, b: 2 }.value?(2)
=> true
irb> { a: 1, b: 2 }.value?(5)
=> false
```
This is pretty straightforward, but there are a couple of nuances I want to point out. For starters, when you are looking for a key, you have to make sure you are looking for the proper datatype. For example, if you have a hash with symbol keys, searching for a string will return false. 
```
irb> { a: 1, b: 2 }.key?("b")
=> false
```
Make sure the datatype you are searching for matches the datatype of your keys or values. 

<a name="fetch"></a>
# [`fetch`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-fetch)
Now we know how we can check if we have a specific key or value, but what if we want to actually look up the value for a key? Well, there is always the standard way to do it and this is what I learned first. 
``` 
irb> h = { a: 1, b: 2, c: 3 }
irb> h[:a] 
=> 1
irb> h[:d] 
=> nil
```
Simple and easy. If the key is there, we return its value. If the key is not there we return nil. But what if we have some more complicated logic? For example, what if we want to return the key's value OR, if the key does not exist, we want to return some default, like 0? With what we know so far we could do this
```ruby
h = { a: 1, b: 2, c: 3 }
if h[:a]
  result = h[:a]
else
  result = 0
end
```
It works, but it is a pretty decent chunk of code to get it done. Instead, we can replace that large chunk of code with one simple method, `fetch`. `fetch` has a lot of options and behaviors so lets unpack each, one at a time. 

1) **`fetch` with NO arguments** will return the value if it is present. If the value is not present, `fetch` will raise an error. This is great if you want to raise an error when a key cannot be found.
```
irb> h = { a: 1, b: 2, c: 3 }
irb> h.fetch(:a) 
=> 1
irb> h.fetch(:d) 
KeyError: key not found: :d
	from (irb):13:in `fetch'
	from (irb):13
```

2) **`fetch` WITH arguments** will return the value if it is present, just like before. Here is where it gets slick and can help us out with our original use case, if you pass fetch an argument and the key is not present, it will return the argument! 🔥
```
irb> h = { a: 1, b: 2, c: 3 }
irb> h.fetch(:a, 0) 
=> 1
irb> h.fetch(:d, 0) 
=> 0
```

<a name="dig"></a>
# [`dig`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-dig)
`fetch` works great when you have a single level hash and want to return a value from it using a key. But what if you have several nested hashes? For example
```ruby
h = { a: { b: { c: 1 } } }
```
Normally to get the value of c you would want to do
```
irb> h[:a][:b][:c] 
=> 1
```
which would traverse your nested hashes and return your value. But what if you are not sure whether all those levels are present? For example, let's say you are working with an API to get user data. Sometimes you find the user you are looking for and get this back.
```ruby
{ user: { first: 'mary', last: 'sue' } }
```
Other times, you don't find the user you want and you get this back,
```ruby
{ status: 'not found' }
```
In this case, we can't just assume we have the user information, because if we don't have the user information, we will end up raising an error.
```
irb> h = { status: 'not found' }
irb> h[:user][:first] 
=> NoMethodError: undefined method `[]' for nil:NilClass
```
To avoid this, we could do
```ruby
h = { status: 'not found' }
if h[:user].present?
  result = h[:user][:first]
else
  result = nil
end
```
This ensures if we have the user data, we return the first name. If we don't have the data, then we return nil. Turns out, we can avoid ALL of this by using `dig`. [`dig`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-dig) extracts the nested value specified by a sequence of key objects. **However, if any one of those nested keys do not exist, it will return nil.** 🎉
```
irb> h = { user: { first: 'mary', last: 'sue' } }
irb> h.dig(:user, :first) 
=> 'mary'
irb> h = { status: 'not found' }
irb> h.dig(:user, :first) 
=> nil
```
`dig` is great when you want to traverse a hash but are not sure what its structure might be. It allows you to work with a hash without worrying about handling a bunch of errors or doing a bunch of `present?` checks using if/else blocks.

<a name="transform_keys"></a>
# [`transform_keys`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-transform_keys) (Only available in Ruby 2.5 and above)
Now we are going to kick it up a notch. What if we have a hash where all the keys are symbols, but we want to change them all to strings? In the early days we would do this.
```ruby
new_hash = {}
{ a: 1, b: 2, c: 3 }.each do |key, value|
  new_hash[key.to_s] = value
end
# new_hash = { "a" => 1, "b" => 2, "c" => 3 }
```
It works, but you guessed it, now there is a better way. That better way is `transform_keys`. [`transform_keys`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-transform_keys) allows you to iterate over a hash and will return a new hash. The new hash keys will be the result from executing the block for each of the original keys.
```ruby
h = { a: 1, b: 2, c: 3 }
new_hash = h.transform_keys do |k| 
  k.to_s 
end  
# new_hash = { "a" => 1, "b" => 2, "c" => 3 }       
```
**IMPORTANT** `transform_keys`(above) and `transform_values`(below) are only available in Ruby 2.5 and above. If you get the following error, then you are likely working with a version of Ruby below 2.5 `NoMethodError: undefined method `transform_keys` for {:a=>1, :b=>2, :c=>3}:Hash`

<a name="transform_values"></a>
# [`transform_values`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-transform_values) (Only available in Ruby 2.5 and above)
`transform_values` works the exact same way as `transform_keys`, except it allows you to update the values. When it is done executing your block, it will return a new hash with the new set of values.
```ruby
h = { a: 1, b: 2, c: 3 }
new_hash = h.transform_values do |value| 
  value * 2 
end  
# new_hash = { :a => 2, :b => 4, :c => 6 }      
```

<a name="select"></a>
# [`select`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-select)
Now we are going to get into some familiar territory if you read my first [array tutorial](https://dev.to/molly_struve/level-up-your-ruby-skillz-working-with-arrays-hnn). Just like for arrays, you can use `select` for hashes! [`select`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-select) for a hash works basically the same as an array, it returns a new hash with the key/value pairs that your block evaluated true for. 
```ruby
# clunky way
new_hash = {}
h = { a: 1, b: 2, c: 3, d: 4 }
h.each do |key, value| 
  new_hash[key] = value if value.even?
end  
# new_hash = { :b => 2, :d => 4 }

# slick select way
h = { a: 1, b: 2, c: 3, d: 4 }
new_hash = h.select do |key, value| 
  value.even?
end  
# new_hash = { :b => 2, :d => 4 }
```

<a name="slice"></a>
# [`slice`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-slice)
Let's say you have a hash and you just want back a specific set of keys and their values. You could do something like this
```ruby
key_list = [:a, :d]
h = { a: 1, b: 2, c: 3, d: 4 }
new_hash = h.select do |key, value| 
  key_list.include?(key)
end  
# new_hash = { :a => 1, :d => 4 }
```
But Ruby has a simpler way and that is by using `slice`. [`slice`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-slice) will return a hash with only the keys you request via your arguments. What we have above can be simplified to
```ruby
h = { a: 1, b: 2, c: 3, d: 4 }
new_hash = h.slice(:a, :d) 
# new_hash = { :a => 1, :d => 4 }
```

<a name="reject"></a>
# [`reject`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-reject)
Back we go again to familiar array territory. `reject` for a hash works the same way it does for an array. [`reject`](https://ruby-doc.org/core-2.6.0.preview2/Hash.html#method-i-reject) will return a new hash consisting of all the key/value pairs for which your block returns false.
```ruby
h = { a: 1, b: 2, c: 3, d: 4 }
new_hash = h.reject do |key, value| 
  value.even?
end  
# new_hash = { :a => 1, :c => 3 }
```

<a name="chaining"></a>
# `chaining`
Last, but not least, we need to cover chaining. Any of the methods above that return a hash, you can chain together. For these examples I am going to use bracket notation because I think it's easier to read chaining methods from left to right, rather than up and down. 

Here is an example of chaining some of the above methods together.
```ruby
h = { a: 1, b: 2, c: 3, d: 4 }
result = h.transform_keys{|k| k.to_s}.slice("a", "b").reject{|k, v| v == 2}.transform_values{|value| "hi #{value}"} 
# result = {"a"=>"hi 1"}
```
Let's break down what is happening here given what we learned above. 
1) `transform_keys` changes each of the hash's keys to a string and returns `{ "a" => 1, "b" => 2, "c" => 3 , "d" => 4}`
2) `slice` will select only keys "a" and "b" and their values and return `{ "a" => 1, "b" => 2 }` 
3) `reject` will remove any key/value pair where the value is equal to 2, that leaves us with `{ "a" => 1 }`
4) Our final `transform_values` will change our hash's values into a string with "hi" and our number following it. The final result is `{"a"=>"hi 1"}`

# BOOM!💥
![](https://thepracticaldev.s3.amazonaws.com/i/omdld3l7yz2zsc0xuewb.gif)
You made it to the end!!! Hopefully you are feeling a little more comfortable with Ruby hashes now and have a couple more methods in your toolbox that you can use. If you have any questions or anything needs clarification please don't hesitate to drop a question in the comments! 

If you want a quick reference for these methods I made a [handy cheat sheet](https://paper.dropbox.com/doc/Handy-Ruby-Hash-Methods--AdDf0Q90cMJJ8Xos__W_Un09AQ-vXrU498IlJByJtgHG9o6f) with just the code from each example.