[Ruby on Rails (RoR)] Differences Between nil?, empty?, blank?, and present? in Ruby on Rails

Posted on Edited on In , , , Views: Word count in article: 4.5k Reading time ≈ 4 mins.

nil?, empty?, blank?, and present?

Ruby and Rails have several methods that can be used to check for the existence of a value or the state of an object. Ruby provides #nil? and #empty?, and Rails’ ActiveSupport adds #blank? and #present?. All these work in their own way and it’s important to know how each evaluates data as using the wrong method in your code might cause unexpected results.

In this article, we’ll refresh your knowledge on these methods. We’ll (re)learn what conditions pass or fail when each is used as well as the type of objects each method can be used on. We’ll even throw in a handy cheat sheet at the end!

#nil?

#nil? is a Ruby method on the Object class. Since all classes inherit from this class, #nil? can be used on any object. It returns true for nil (an instance of the class NilClass) and false for everything else.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
nil.nil?
=> true

true.nil?
=> false

5.nil?
=> false

"".nil?
=> false

[].nil?
=> false

#empty?

#empty? is a method that can be used on strings, arrays, hashes and sets. It returns true if the instance of the object has a length of zero.

When used on strings, it returns true for empty strings.

1
2
"".empty?
=> true

Note that whitespace characters are characters and so using #empty? on a string containing only whitespace will return false. Because of this, it might not be the best method to use when validating text. If you are only using this method to validate user input, for instance, you might end up processing input that only contains whitespace.

1
2
3
4
5
" ".empty?
=> false

"\t\n".empty?
=> false

For arrays, hashes and sets, it returns true if they have no elements.

1
2
3
4
5
6
7
8
9
[].empty?
=> true

{}.empty?
=> true

require 'set'
Set.new.empty?
=> true

When #empty? is used on nil or any other class that doesn’t have the method, a NoMethodError exception will be raised. So to use it in checking your data, you have to put in place more checks to ensure your program never crashes.

1
2
3
4
if !my_var.nil? && !my_var.empty?
# or if my_var&.empty?
  # make use of my_var
end

A better method to use would be the Rails #blank? method, which we’ll now look at.

#blank?

#blank? is a Rails method (in ActiveSupport). It operates on any object.

For strings, it will return true for empty strings as well as strings containing only whitespace characters.

1
2
3
4
5
6
7
8
"".blank?
=> true

" ".blank?
=> true

"\n\t".blank?
=> true

For arrays, hashes and sets, it works just like #empty?, in that it returns true if they have no elements.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
[].blank?
=> true

{}.blank?
=> true

Set.new.blank?
=> true

[nil].blank?
=> false

["", ""].blank?
=> false

person = {:firstName => "John", :lastName => "Doe"}
person.blank?
=> false

It returns false for true and true for any falsey conditions (i.e. nil and false).

1
2
3
4
5
6
7
8
true.blank?
=> false

false.blank?
=> true

nil.blank?
=> true

As you can see, it is better to use #blank? rather than #empty? in validating data as it won’t cause NoMethodErrors when used on some objects since it is available for all objects. It also won’t pass for strings that only contain whitespace.

#present?

#present? is also a Rails method. It does the opposite of what #blank? does.

1
2
!my_var.blank? == my_var.present?
=> true

Here are some examples:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
"".present?
=> false

" ".present?
=> false

[].present?
=> false

nil.present?
=> false

true.present?
=> true

false.present?
=> false

{}.present?
=> false

person = {:firstName => "John", :lastName => "Doe"}
person.present?
=> true

5.present?
=> true

This is also a better method for validation than #empty? for the same reasons we covered for #blank?.

Summary

I’d roughly summarize my approach to these methods like this:

  • As much as possible to use blank? or present? to check semantics empty or not empty.

  • Rarely use nil? or empty?.

Since the naming of these methods tends to confuse, here’s a handy cheat sheet for you to bookmark.

#nil? #empty? #blank? #present?
5 false NoMethodError false true
“” false true true false
" " false false true
“\t\n” false false true false
[] false true true false
[“a”] false false false true
{} false true true false
{a: “b”} false false false true
Set.new false true true false
nil true NoMethodError true false
true false NoMethodError false true
false false NoMethodError true false

As with everything, the choice between #nil?, #empty?, #blank? and #present? depends on the situation. For checking if a user has a name to address them with, #present? could be a good fit, for example. However #blank? and #present return a boolean for all objects, which might hide bugs in the code by not raising an error when a value is of the wrong type.

References

[1] Differences Between #nil?, #empty?, #blank?, and #present? | AppSignal Blog - https://blog.appsignal.com/2018/09/11/differences-between-nil-empty-blank-and-present.html

[2] .nil? .empty? .blank? .present? 傻傻分不清楚？ - Leon’s Blogging - https://mgleon08.github.io/blog/2015/12/16/ruby-on-rail-nil-empty-blank-present/