diff options
author | Xavier Noria <fxn@hashref.com> | 2010-08-01 03:19:30 +0200 |
---|---|---|
committer | Xavier Noria <fxn@hashref.com> | 2010-08-01 03:19:58 +0200 |
commit | f78de6864998369002a5b1906dad151b6c787c24 (patch) | |
tree | 4e71fab1ebff3921c5cc511364d9e347863559cc /activesupport/lib/active_support/core_ext/array/wrap.rb | |
parent | 96f8325116148848cf2a6ec7d8561df8955ffaa3 (diff) | |
download | rails-f78de6864998369002a5b1906dad151b6c787c24.tar.gz rails-f78de6864998369002a5b1906dad151b6c787c24.tar.bz2 rails-f78de6864998369002a5b1906dad151b6c787c24.zip |
explains Array.wrap directly, rather by comparison with Kernel#Array which is too obscure, leaves the comparison to document the differences, and adds a comparison with the related idiom that uses the splat operator
Diffstat (limited to 'activesupport/lib/active_support/core_ext/array/wrap.rb')
-rw-r--r-- | activesupport/lib/active_support/core_ext/array/wrap.rb | 23 |
1 files changed, 22 insertions, 1 deletions
diff --git a/activesupport/lib/active_support/core_ext/array/wrap.rb b/activesupport/lib/active_support/core_ext/array/wrap.rb index 09a1c2e5a1..06b2acd662 100644 --- a/activesupport/lib/active_support/core_ext/array/wrap.rb +++ b/activesupport/lib/active_support/core_ext/array/wrap.rb @@ -1,5 +1,17 @@ class Array - # <tt>Array.wrap</tt> is like <tt>Kernel#Array</tt> except: + # Wraps its argument in an array unless it is already an array (or array-like). + # + # Specifically: + # + # * If the argument is +nil+ an empty list is returned. + # * Otherwise, if the argument responds to +to_ary+ it is invoked, and its result returned. + # * Otherwise, returns an array with the argument as its single element. + # + # Array.wrap(nil) # => [] + # Array.wrap([1, 2, 3]) # => [1, 2, 3] + # Array.wrap(0) # => [0] + # + # This method is similar in purpose to <tt>Kernel#Array</tt>, but there are some differences: # # * If the argument responds to +to_ary+ the method is invoked. <tt>Kernel#Array</tt> # moves on to try +to_a+ if the returned value is +nil+, but <tt>Arraw.wrap</tt> returns @@ -15,6 +27,15 @@ class Array # # Array("foo\nbar") # => ["foo\n", "bar"], in Ruby 1.8 # Array.wrap("foo\nbar") # => ["foo\nbar"] + # + # There's also a related idiom that uses the splat operator: + # + # [*object] + # + # which returns <tt>[nil]</tt> for +nil+, and calls to <tt>Array(object)</tt> otherwise. + # + # Thus, in this case the behavior is different for +nil+, and the differences with + # <tt>Kernel#Array</tt> explained above apply to the rest of +object+s. def self.wrap(object) if object.nil? [] |