_.chunk(array, [size=1])复制代码
将数组(array)拆分成多个 size 长度的区块,并将这些区块组成一个新数组。 如果array 无法被分割成全部等长的区块,那么最后剩余的元素将组成一个区块。
使用方法
chunk(['a', 'b', 'c', 'd'], 2) // => [['a', 'b'], ['c', 'd']] chunk(['a', 'b', 'c', 'd'], 3) // => [['a', 'b', 'c'], ['d']]复制代码
值得注意的是,这是一个纯函数,不会对传入的data有任何影响。
源码分析
var baseSlice = require('./_baseSlice'), isIterateeCall = require('./_isIterateeCall'), toInteger = require('./toInteger');/* Built-in method references for those with the same name as other `lodash` methods. */var nativeCeil = Math.ceil, nativeMax = Math.max;/** * Creates an array of elements split into groups the length of `size`. * If `array` can't be split evenly, the final chunk will be the remaining * elements. * * @static * @memberOf _ * @since 3.0.0 * @category Array * @param {Array} array The array to process. * @param {number} [size=1] The length of each chunk * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`. * @returns {Array} Returns the new array of chunks. * @example * * _.chunk(['a', 'b', 'c', 'd'], 2); * // => [['a', 'b'], ['c', 'd']] * * _.chunk(['a', 'b', 'c', 'd'], 3); * // => [['a', 'b', 'c'], ['d']] */function chunk(array, size, guard) { if ((guard ? isIterateeCall(array, size, guard) : size === undefined)) { size = 1; } else { size = nativeMax(toInteger(size), 0); } var length = array == null ? 0 : array.length; if (!length || size < 1) { return []; } var index = 0, resIndex = 0, result = Array(nativeCeil(length / size)); while (index < length) { result[resIndex++] = baseSlice(array, index, (index += size)); } return result;}module.exports = chunk;复制代码
这个方法整体实现没有很特别的地方,核心在于用Math.ceil对原数组分区块,然后循环切割原数组。while循环写得比较精简,将运算和赋值写在一起,对于不熟悉的人来说可能有点懵逼。这个方法有一个比较令人困惑的地方在于第三个参数guard以及isIterateeCall方法,这个参数在官网上没有提及,一般我们调用chunk方法都只会传前两个参数,只有当我们这整个方法作为map之类方法的参数时,才会有第三个参数,那么此时array就是当前元素,size就是index,而gard就变成了原数组,这种情况下会对原数组进行size=1的分割。当然不是只要有三个参数就可以认为这是Iteratee的情况,简而言之就是判断gard[size]是否等于array,具体的isIterateeCall实现可以看如下代码:
var eq = require('./eq'), isArrayLike = require('./isArrayLike'), isIndex = require('./_isIndex'), isObject = require('./isObject');/** * Checks if the given arguments are from an iteratee call. * * @private * @param {*} value The potential iteratee value argument. * @param {*} index The potential iteratee index or key argument. * @param {*} object The potential iteratee object argument. * @returns {boolean} Returns `true` if the arguments are from an iteratee call, * else `false`. */function isIterateeCall(value, index, object) { if (!isObject(object)) { return false; } var type = typeof index; if (type == 'number' ? (isArrayLike(object) && isIndex(index, object.length)) : (type == 'string' && index in object) ) { return eq(object[index], value); } return false;}module.exports = isIterateeCall;复制代码