take.js
 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;