diff options
author | Christos Zisopoulos <christos@42linesofcode.com> | 2009-01-26 00:47:05 +0000 |
---|---|---|
committer | Pratik Naik <pratiknaik@gmail.com> | 2009-01-26 00:50:21 +0000 |
commit | 6df580a0a8fe9c5df2353e5b435590a9a1cab3de (patch) | |
tree | d2c4ad77a17a51d827a642018dd3d7cfcb84f8f8 /activesupport/lib | |
parent | c9b8a26ba1cd8277580fc2a554fe3a67a52f1756 (diff) | |
download | rails-6df580a0a8fe9c5df2353e5b435590a9a1cab3de.tar.gz rails-6df580a0a8fe9c5df2353e5b435590a9a1cab3de.tar.bz2 rails-6df580a0a8fe9c5df2353e5b435590a9a1cab3de.zip |
An updated description of Object#try to better reflect changes documented at http://is.gd/hdmo and http://is.gd/hdmQ
Signed-off-by: Pratik Naik <pratiknaik@gmail.com>
Diffstat (limited to 'activesupport/lib')
-rw-r--r-- | activesupport/lib/active_support/core_ext/try.rb | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/activesupport/lib/active_support/core_ext/try.rb b/activesupport/lib/active_support/core_ext/try.rb index 0dccd40c55..5cee97fd0d 100644 --- a/activesupport/lib/active_support/core_ext/try.rb +++ b/activesupport/lib/active_support/core_ext/try.rb @@ -1,6 +1,9 @@ class Object - # 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. + # Invokes the method identified by +symbol+, 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. # # ==== Examples # @@ -12,11 +15,13 @@ class Object # With try # @person.try(:name) # - # Try also accepts arguments/blocks for the method it is trying + # +try+ also accepts arguments and/or a block, for the method it is trying # Person.try(:find, 1) # @people.try(:collect) {|p| p.name} #-- - # This method def is for rdoc only. The alias_method below overrides it as an optimization. + # 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(method, *args, &block) send(method, *args, &block) end |