Sha256: 4a6c2d0283a96b3150fdde3852a8a9ea5aaeb437705cbfa1232a4844157bcac3

Contents?: true

Size: 1.45 KB

Versions: 10

Compression:

Stored size: 1.45 KB

Contents

module Kernel
  # An object is blank if it's nil, empty, or a whitespace string.
  # For example, "", "   ", nil, [], and {} are blank.
  #
  # This simplifies...
  #
  #   if !address.nil? && !address.empty?
  #
  # to...
  #
  #   if !address.blank?
  #
  def blank?
    return empty? if respond_to?(:empty?)
    !self
  end

  # An object is present if it's not blank.
  def present?
    !blank?
  end

  # 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'
  #
  def presence
    self if present?
  end
end

class NilClass
  def blank?
    true
  end
end

class FalseClass
  def blank?
    true
  end
end

class TrueClass
  def blank?
    false
  end
end

class Array
  alias_method :blank?, :empty?
end

class Hash
  alias_method :blank?, :empty?
end

class String
  # Is this string just whitespace?
  #
  #   "abc".blank?  #=> false
  #   "   ".blank?  #=> true
  def blank?
    /\S/ !~ self
  end
end

class Numeric
  def blank?
    false
  end
end

Version data entries

10 entries across 9 versions & 2 rubygems

Version Path
facets-glimmer-3.2.0 lib/core/facets/kernel/blank.rb
facets-3.1.0 lib/core/facets/kernel/blank.rb
facets-3.0.0 lib/core/facets/kernel/blank.rb
facets-2.9.3 lib/core/facets/kernel/blank.rb
facets-2.9.2 src/core/facets/kernel/blank.rb
facets-2.9.2 lib/core/facets/kernel/blank.rb
facets-2.9.1 lib/core/facets/kernel/blank.rb
facets-2.9.0 lib/core/facets/kernel/blank.rb
facets-2.9.0.pre.2 lib/core/facets/kernel/blank.rb
facets-2.9.0.pre.1 lib/core/facets/kernel/blank.rb