1 | var baseSlice = require('./_baseSlice'),
|
2 | isIterateeCall = require('./_isIterateeCall'),
|
3 | toInteger = require('./toInteger');
|
4 |
|
5 | /* Built-in method references for those with the same name as other `lodash` methods. */
|
6 | var nativeCeil = Math.ceil,
|
7 | nativeMax = Math.max;
|
8 |
|
9 | /**
|
10 | * Creates an array of elements split into groups the length of `size`.
|
11 | * If `array` can't be split evenly, the final chunk will be the remaining
|
12 | * elements.
|
13 | *
|
14 | * @static
|
15 | * @memberOf _
|
16 | * @since 3.0.0
|
17 | * @category Array
|
18 | * @param {Array} array The array to process.
|
19 | * @param {number} [size=1] The length of each chunk
|
20 | * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`.
|
21 | * @returns {Array} Returns the new array of chunks.
|
22 | * @example
|
23 | *
|
24 | * _.chunk(['a', 'b', 'c', 'd'], 2);
|
25 | * // => [['a', 'b'], ['c', 'd']]
|
26 | *
|
27 | * _.chunk(['a', 'b', 'c', 'd'], 3);
|
28 | * // => [['a', 'b', 'c'], ['d']]
|
29 | */
|
30 | function chunk(array, size, guard) {
|
31 | if ((guard ? isIterateeCall(array, size, guard) : size === undefined)) {
|
32 | size = 1;
|
33 | } else {
|
34 | size = nativeMax(toInteger(size), 0);
|
35 | }
|
36 | var length = array == null ? 0 : array.length;
|
37 | if (!length || size < 1) {
|
38 | return [];
|
39 | }
|
40 | var index = 0,
|
41 | resIndex = 0,
|
42 | result = Array(nativeCeil(length / size));
|
43 |
|
44 | while (index < length) {
|
45 | result[resIndex++] = baseSlice(array, index, (index += size));
|
46 | }
|
47 | return result;
|
48 | }
|
49 |
|
50 | module.exports = chunk;
|