Class: Object
- Inherits:
- BasicObject
- Defined in:
- lib/roda/component/object/blank.rb,
lib/roda/component/object/try.rb
Overview
Instance Method Summary collapse
-
#blank? ⇒ true, false
An object is blank if it’s false, empty, or a whitespace string.
-
#presence ⇒ Object
Returns the receiver if it’s present otherwise returns
nil
. -
#present? ⇒ true, false
An object is present if it’s not blank.
-
#try(*a, &b) ⇒ Object
Invokes the public method whose name goes as first argument just like
public_send
does, except that if the receiver does not respond to it the call returnsnil
rather than raising an exception. -
#try!(*a, &b) ⇒ Object
Same as #try, but raises a NoMethodError exception if the receiver is not
nil
and does not implement the tried method.
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?
18 19 20 |
# File 'lib/roda/component/object/blank.rb', line 18 def blank? respond_to?(:empty?) ? !!empty? : !self 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'
45 46 47 |
# File 'lib/roda/component/object/blank.rb', line 45 def presence self if present? end |
#present? ⇒ true, false
An object is present if it’s not blank.
25 26 27 |
# File 'lib/roda/component/object/blank.rb', line 25 def present? !blank? end |
#try(*a, &b) ⇒ Object
Invokes the public method whose name goes as first argument just like public_send
does, except that if the receiver does not respond to it the call returns nil
rather than raising an exception.
This method is defined to be able to write
@person.try(:name)
instead of
@person.name if @person
try
calls can be chained:
@person.try(:spouse).try(:name)
instead of
@person.spouse.name if @person && @person.spouse
try
will also return nil
if the receiver does not respond to the method:
@person.try(:non_existing_method) # => nil
instead of
@person.non_existing_method if @person.respond_to?(:non_existing_method) # => nil
try
returns nil
when called on nil
regardless of whether it responds to the method:
nil.try(:to_i) # => nil, rather than 0
Arguments and blocks are forwarded to the method if invoked:
@posts.try(:each_slice, 2) do |a, b|
...
end
The number of arguments in the signature must match. If the object responds to the method the call is attempted and ArgumentError
is still raised in case of argument mismatch.
If try
is called without arguments it yields the receiver to a given block unless it is nil
:
@person.try do |p|
...
end
You can also call try with a block without accepting an argument, and the block will be instance_eval’ed instead:
@person.try { upcase.truncate(50) }
Please also note that try
is defined on Object
. Therefore, it won’t work with instances of classes that do not have Object
among their ancestors, like direct subclasses of BasicObject
. For example, using try
with SimpleDelegator
will delegate try
to the target instead of calling it on the delegator itself.
62 63 64 |
# File 'lib/roda/component/object/try.rb', line 62 def try(*a, &b) try!(*a, &b) if a.empty? || respond_to?(a.first) end |
#try!(*a, &b) ⇒ Object
Same as #try, but raises a NoMethodError exception if the receiver is not nil
and does not implement the tried method.
"a".try!(:upcase) # => "A"
nil.try!(:upcase) # => nil
123.try!(:upcase) # => NoMethodError: undefined method `upcase' for 123:Fixnum
72 73 74 75 76 77 78 79 80 81 82 |
# File 'lib/roda/component/object/try.rb', line 72 def try!(*a, &b) if a.empty? && block_given? if b.arity.zero? instance_eval(&b) else yield self end else public_send(*a, &b) end end |