Class: Object
- Inherits:
- BasicObject
- Defined in:
- lib/kinokero/blank.rb
Instance Method Summary collapse
-
#blank? ⇒ Boolean
An object is blank if it’s false, empty, or a whitespace string.
-
#presence ⇒ Object
Returns object if it’s
present?
otherwise returnsnil
. -
#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?
14 15 16 |
# File 'lib/kinokero/blank.rb', line 14 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'
37 38 39 |
# File 'lib/kinokero/blank.rb', line 37 def presence self if present? end |
#present? ⇒ Boolean
An object is present if it’s not blank?
.
19 20 21 |
# File 'lib/kinokero/blank.rb', line 19 def present? !blank? end |