Class: Object

Inherits:
BasicObject
Defined in:
lib/jenkins/core_ext/object/blank.rb

Overview

Vendored from activesupport 3.0.1

Instance Method Summary collapse

Instance Method Details

#blank? ⇒ Boolean

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

This simplifies:

if !address.nil? && !address.empty?

…to:

if !address.blank?

Returns:

  • (Boolean) 


13
14
15
 
# File 'lib/jenkins/core_ext/object/blank.rb', line 13

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[: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'



36
37
38
 
# File 'lib/jenkins/core_ext/object/blank.rb', line 36

def presence
  self if present?
end

#present? ⇒ Boolean

An object is present if it’s not blank.

Returns:

  • (Boolean) 


18
19
20
 
# File 'lib/jenkins/core_ext/object/blank.rb', line 18

def present?
  !blank?
end