instance method `presence`

Ruby on Rails 3.2.22.5

Since v2.3.18

Available in: v2.3.18 v3.0.20 v3.1.12 v3.2.22.5 v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

presence()

Returns object if it’s present? otherwise returns nil. object.presence is equivalent to object.present? ? object : nil.

This is handy for any representation of objects where blank is the same as not present at all. For example, this simplifies a common check for HTTP POST/query parameters:

state   = params[:state]   if params[:state].present?
country = params[:country] if params[:country].present?
region  = state || country || 'US'

…becomes:

region = params[:state].presence || params[:country].presence || 'US'

Source

# File activesupport/lib/active_support/core_ext/object/blank.rb, line 38
  def presence
    self if present?
  end

Defined in activesupport/lib/active_support/core_ext/object/blank.rb line 38 · View on GitHub · Improve this page · Find usages on GitHub

Defined in Object

Signature