Class | Array |
In: |
lib/whois/core_ext/array/extract_options.rb
lib/whois/core_ext/array/wrap.rb |
Parent: | Object |
Wraps its argument in an array unless it is already an array (or array-like).
Specifically:
Array.wrap(nil) # => [] Array.wrap([1, 2, 3]) # => [1, 2, 3] Array.wrap(0) # => [0]
This method is similar in purpose to Kernel#Array, but there are some differences:
moves on to try to_a if the returned value is nil, but Array.wrap returns such a nil right away.
raises an exception, while Array.wrap does not, it just returns the value.
The last point is particularly worth comparing for some enumerables:
Array(:foo => :bar) # => [[:foo, :bar]] Array.wrap(:foo => :bar) # => [{:foo => :bar}] 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 [nil] for nil, and calls to Array(object) otherwise.
Thus, in this case the behavior is different for nil, and the differences with Kernel#Array explained above apply to the rest of +object+s.