Module ActiveSupport::CoreExtensions::Array::Grouping
In: vendor/rails/activesupport/lib/active_support/core_ext/array/grouping.rb

Methods

Public Instance methods

Iterate over an array in groups of a certain size, padding any remaining slots with specified value (nil by default) unless it is false.

E.g.

  %w(1 2 3 4 5 6 7).in_groups_of(3) {|g| p g}
  ["1", "2", "3"]
  ["4", "5", "6"]
  ["7", nil, nil]

  %w(1 2 3).in_groups_of(2, ' ') {|g| p g}
  ["1", "2"]
  ["3", " "]

  %w(1 2 3).in_groups_of(2, false) {|g| p g}
  ["1", "2"]
  ["3"]

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/array/grouping.rb, line 25
25:         def in_groups_of(number, fill_with = nil, &block)
26:           if fill_with == false
27:             collection = self
28:           else
29:             # size % number gives how many extra we have;
30:             # subtracting from number gives how many to add;
31:             # modulo number ensures we don't add group of just fill.
32:             padding = (number - size % number) % number
33:             collection = dup.concat([fill_with] * padding)
34:           end
35: 
36:           if block_given?
37:             collection.each_slice(number, &block)
38:           else
39:             returning [] do |groups|
40:               collection.each_slice(number) { |group| groups << group }
41:             end
42:           end
43:         end

Divide the array into one or more subarrays based on a delimiting value or the result of an optional block.

ex.

  [1, 2, 3, 4, 5].split(3)                # => [[1, 2], [4, 5]]
  (1..10).to_a.split { |i| i % 3 == 0 }   # => [[1, 2], [4, 5], [7, 8], [10]]

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/array/grouping.rb, line 52
52:         def split(value = nil, &block)
53:           block ||= Proc.new { |e| e == value }
54: 
55:           inject([[]]) do |results, element|
56:             if block.call(element)
57:               results << []
58:             else
59:               results.last << element
60:             end
61: 
62:             results
63:           end
64:         end

[Validate]