Sha256: dff326e72691264732ffcac7e4b38a95db4017d45e475cd7b521f62eb474d82d

Contents?: true

Size: 1.58 KB

Versions: 16

Compression:

Stored size: 1.58 KB

Contents

unless Object.method_defined?(:try)
class Object
  # Invokes the method identified by the symbol +method+, passing it any arguments
  # and/or the block specified, just like the regular Ruby <tt>Object#send</tt> does.
  #
  # *Unlike* that method however, a +NoMethodError+ exception will *not* be raised
  # and +nil+ will be returned instead, if the receiving object is a +nil+ object or NilClass.
  #
  # If try is called without a method to call, it will yield any given block with the object.
  #
  # ==== Examples
  #
  # Without +try+
  #   @person && @person.name
  # or
  #   @person ? @person.name : nil
  #
  # With +try+
  #   @person.try(:name)
  #
  # +try+ also accepts arguments and/or a block, for the method it is trying
  #   Person.try(:find, 1)
  #   @people.try(:collect) {|p| p.name}
  #
  # Without a method argument try will yield to the block unless the receiver is nil.
  #   @person.try { |p| "#{p.first_name} #{p.last_name}" }
  #--
  # +try+ behaves like +Object#send+, unless called on +NilClass+.
  def try(*a, &b)
    if a.empty? && block_given?
      yield self
    elsif !a.empty? && !respond_to?(a.first)
      nil
    else
      __send__(*a, &b)
    end
  end
end

class NilClass
  # Calling +try+ on +nil+ always returns +nil+.
  # It becomes specially helpful when navigating through associations that may return +nil+.
  #
  # === Examples
  #
  #   nil.try(:name) # => nil
  #
  # Without +try+
  #   @person && !@person.children.blank? && @person.children.first.name
  #
  # With +try+
  #   @person.try(:children).try(:first).try(:name)
  def try(*args)
    nil
  end
end
end

Version data entries

16 entries across 16 versions & 1 rubygems

Version Path
gorillib-0.6.0 lib/gorillib/object/try.rb
gorillib-0.5.2 lib/gorillib/object/try.rb
gorillib-0.5.0 lib/gorillib/object/try.rb
gorillib-0.4.2 lib/gorillib/object/try.rb
gorillib-0.4.2pre lib/gorillib/object/try.rb
gorillib-0.4.0pre lib/gorillib/object/try.rb
gorillib-0.4.1pre lib/gorillib/object/try.rb
gorillib-0.1.11 lib/gorillib/object/try.rb
gorillib-0.1.9 lib/gorillib/object/try.rb
gorillib-0.1.8 lib/gorillib/object/try.rb
gorillib-0.1.7 lib/gorillib/object/try.rb
gorillib-0.1.6 lib/gorillib/object/try.rb
gorillib-0.1.5 lib/gorillib/object/try.rb
gorillib-0.1.4 lib/gorillib/object/try.rb
gorillib-0.1.3 lib/gorillib/object/try.rb
gorillib-0.1.2 lib/gorillib/object/try.rb