Class: Object

Inherits:

BasicObject

Defined in:

lib/yarder/core_ext/object/blank.rb

Instance Method Summary

• #blank? ⇒ Boolean

  An object is blank if it’s false, empty, or a whitespace string.

• #presence ⇒ Object

  Returns object if it’s present? otherwise returns nil.

• #present? ⇒ Boolean

  An object is present if it’s not blank?.

Instance Method Details

#blank? ⇒ Boolean

An object is blank if it’s false, empty, or a whitespace string. For example, ”, ‘ ’, nil, [], and {} are all blank.

This simplifies:

if address.nil? || address.empty?

…to:

if address.blank?

Returns:

• (Boolean)

# File 'lib/yarder/core_ext/object/blank.rb', line 18

def blank?
  respond_to?(:empty?) ? empty? : !self
end

#presence ⇒ Object

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 if params.present? country = params if params.present? region = state || country || ‘US’

…becomes:

region = params.presence || params.presence || ‘US’

# File 'lib/yarder/core_ext/object/blank.rb', line 41

def presence
  self if present?
end

#present? ⇒ Boolean

An object is present if it’s not blank?.

Returns:

• (Boolean)

# File 'lib/yarder/core_ext/object/blank.rb', line 23

def present?
  !blank?
end