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;
|