Method: Lotus::Utils::Kernel.Array

Defined in:

lib/lotus/utils/kernel.rb

.Array(arg) ⇒ Array

Coerces the argument to be an Array.

It’s similar to Ruby’s Kernel.Array, but it applies further transformations:

* flatten
* compact
* uniq

Examples:

Basic Usage

require 'lotus/utils/kernel'

Lotus::Utils::Kernel.Array(nil)              # => []
Lotus::Utils::Kernel.Array(true)             # => [true]
Lotus::Utils::Kernel.Array(false)            # => [false]
Lotus::Utils::Kernel.Array(1)                # => [1]
Lotus::Utils::Kernel.Array([1])              # => [1]
Lotus::Utils::Kernel.Array([1, [2]])         # => [1,2]
Lotus::Utils::Kernel.Array([1, [2, nil]])    # => [1,2]
Lotus::Utils::Kernel.Array([1, [2, nil, 1]]) # => [1,2]

Array Interface

require 'lotus/utils/kernel'

ResultSet = Struct.new(:records) do
  def to_a
    records.to_a.sort
  end
end

Response = Struct.new(:status, :headers, :body) do
  def to_ary
    [status, headers, body]
  end
end

set = ResultSet.new([2,1,3])
Lotus::Utils::Kernel.Array(set)              # => [1,2,3]

response = Response.new(200, {}, 'hello')
Lotus::Utils::Kernel.Array(response)         # => [200, {}, "hello"]

Parameters:

• arg (Object) —

  the input

Returns:

• (Array) —

  the result of the coercion

See Also:

• http://www.ruby-doc.org/core/Kernel.html#method-i-Array
• http://www.ruby-doc.org/core/Array.html#method-i-flatten
• http://www.ruby-doc.org/core/Array.html#method-i-compact
• http://www.ruby-doc.org/core/Array.html#method-i-uniq

Since:

• 0.1.1

# File 'lib/lotus/utils/kernel.rb', line 81

def self.Array(arg)
  super(arg).dup.tap do |a|
    a.flatten!
    a.compact!
    a.uniq!
  end
end