1
|
var baseSlice = require('./_baseSlice'),
|
2
|
toInteger = require('./toInteger');
|
3
|
|
4
|
/**
|
5
|
* Creates a slice of `array` with `n` elements taken from the beginning.
|
6
|
*
|
7
|
* @static
|
8
|
* @memberOf _
|
9
|
* @since 0.1.0
|
10
|
* @category Array
|
11
|
* @param {Array} array The array to query.
|
12
|
* @param {number} [n=1] The number of elements to take.
|
13
|
* @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`.
|
14
|
* @returns {Array} Returns the slice of `array`.
|
15
|
* @example
|
16
|
*
|
17
|
* _.take([1, 2, 3]);
|
18
|
* // => [1]
|
19
|
*
|
20
|
* _.take([1, 2, 3], 2);
|
21
|
* // => [1, 2]
|
22
|
*
|
23
|
* _.take([1, 2, 3], 5);
|
24
|
* // => [1, 2, 3]
|
25
|
*
|
26
|
* _.take([1, 2, 3], 0);
|
27
|
* // => []
|
28
|
*/
|
29
|
function take(array, n, guard) {
|
30
|
if (!(array && array.length)) {
|
31
|
return [];
|
32
|
}
|
33
|
n = (guard || n === undefined) ? 1 : toInteger(n);
|
34
|
return baseSlice(array, 0, n < 0 ? 0 : n);
|
35
|
}
|
36
|
|
37
|
module.exports = take;
|