aboutsummaryrefslogtreecommitdiffstats
path: root/railties
diff options
context:
space:
mode:
authorXavier Noria <fxn@hashref.com>2009-07-15 01:02:46 +0200
committerXavier Noria <fxn@hashref.com>2009-07-15 01:02:46 +0200
commit0a1af53892cb1d46ecf7cfbc9a76e8b9f93f9819 (patch)
tree32fa12beee6c3ce1264698e66b7315e449de8293 /railties
parent6f49e7fe0856c339f592d80ce6552536d9637f02 (diff)
downloadrails-0a1af53892cb1d46ecf7cfbc9a76e8b9f93f9819.tar.gz
rails-0a1af53892cb1d46ecf7cfbc9a76e8b9f93f9819.tar.bz2
rails-0a1af53892cb1d46ecf7cfbc9a76e8b9f93f9819.zip
AS guide: documents Object#returning
Diffstat (limited to 'railties')
-rw-r--r--railties/guides/source/active_support_overview.textile15
1 files changed, 15 insertions, 0 deletions
diff --git a/railties/guides/source/active_support_overview.textile b/railties/guides/source/active_support_overview.textile
index d0e07137cc..de9212c307 100644
--- a/railties/guides/source/active_support_overview.textile
+++ b/railties/guides/source/active_support_overview.textile
@@ -84,6 +84,21 @@ By definition all objects are +duplicable?+ except +nil+, +false+, +true+, symbo
WARNING. Using +duplicable?+ is discouraged because it depends on a hard-coded list. Classes have means to disallow duplication like removing +dup+ and +clone+ or raising exceptions from them, only +rescue+ can tell.
+h4. +returning+
+
+The method +returning+ yields its argument to a block and returns it. You tipically use it with a mutable object that gets modified in the block:
+
+<ruby>
+def html_options_for_form(url_for_options, options, *parameters_for_url)
+ returning options.stringify_keys do |html_options|
+ html_options["enctype"] = "multipart/form-data" if html_options.delete("multipart")
+ html_options["action"] = url_for(url_for_options, *parameters_for_url)
+ end
+end
+</ruby>
+
+See also "+Object#tap+":#tap.
+
h4. +tap+
+Object#tap+ exists in Ruby 1.8.7 and 1.9, and it is defined by Active Support for previous versions. This method yields its receiver to a block and returns it.