Class: Object

Inherits:
BasicObject
Defined in:
lib/vendor/rails_blank.rb,
lib/vendor/rails_inclusion.rb

Overview

Rails 4.2.4

Instance Method Summary collapse

Instance Method Details

#blank? ⇒ true, false

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

This simplifies

address.nil? || address.empty?

to

address.blank?

Returns:

  • (true, false) 


18
19
20
 
# File 'lib/vendor/rails_blank.rb', line 18

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

#in?(another_object) ⇒ Boolean

Returns true if this object is included in the argument. Argument must be any object which responds to #include?. Usage:

characters = ["Konata", "Kagami", "Tsukasa"]
"Konata".in?(characters) # => true

This will throw an ArgumentError if the argument doesn’t respond to #include?.

Returns:

  • (Boolean) 


10
11
12
13
14
 
# File 'lib/vendor/rails_inclusion.rb', line 10

def in?(another_object)
  another_object.include?(self)
rescue NoMethodError
  raise ArgumentError.new("The parameter passed to #in? must respond to #include?")
end

#presence ⇒ Object

Returns the receiver if it’s present otherwise returns nil. object.presence is equivalent to

object.present? ? object : nil

For example, something like

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'

Returns:



45
46
47
 
# File 'lib/vendor/rails_blank.rb', line 45

def presence
  self if present?
end

#presence_in(another_object) ⇒ Object

Returns the receiver if it’s included in the argument otherwise returns nil. Argument must be any object which responds to #include?. Usage:

params[:bucket_type].presence_in %w( project calendar )

This will throw an ArgumentError if the argument doesn’t respond to #include?.

Returns:



24
25
26
 
# File 'lib/vendor/rails_inclusion.rb', line 24

def presence_in(another_object)
  self.in?(another_object) ? self : nil
end

#present? ⇒ true, false

An object is present if it’s not blank.

Returns:

  • (true, false) 


25
26
27
 
# File 'lib/vendor/rails_blank.rb', line 25

def present?
  !blank?
end