diff --git a/activesupport/lib/active_support/core_ext/try.rb b/activesupport/lib/active_support/core_ext/try.rb index c7c7778a779224a10d7100b6ddc3ac5a2fa71627..0dccd40c55f8f35811f7d14706a9edd27bb16294 100644 --- a/activesupport/lib/active_support/core_ext/try.rb +++ b/activesupport/lib/active_support/core_ext/try.rb @@ -1,9 +1,6 @@ class Object - # Invokes the method identified by +symbol+, passing it any arguments - # and/or the block specified, just like the regular Ruby Object#send 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. + # Tries to send the method only if object responds to it. Return +nil+ otherwise. + # It will also forward any arguments and/or block like Object#send does. # # ==== Examples # @@ -15,15 +12,13 @@ class Object # With try # @person.try(:name) # - # +try+ also accepts arguments and/or a block, for the method it is trying + # Try also accepts arguments/blocks for the method it is trying # Person.try(:find, 1) # @people.try(:collect) {|p| p.name} #-- - # This method definition below is for rdoc purposes only. The alias_method call - # below overrides it as an optimization since +try+ behaves like +Object#send+, - # unless called on +NilClass+. - def try(symbol, *args, &block) - send(symbol, *args, &block) + # This method def is for rdoc only. The alias_method below overrides it as an optimization. + def try(method, *args, &block) + send(method, *args, &block) end alias_method :try, :__send__ end