lodash/take.js

import baseSlice from './.internal/baseSlice.js'
import toInteger from './toInteger.js'

/**
 * Creates a slice of `array` with `n` elements taken from the beginning.
 *
 * @since 0.1.0
 * @category Array
 * @param {Array} array The array to query.
 * @param {number} [n=1] The number of elements to take.
 * @param- {Object} [guard] Enables use as an iteratee for methods like `map`.
 * @returns {Array} Returns the slice of `array`.
 * @example
 *
 * take([1, 2, 3])
 * // => [1]
 *
 * take([1, 2, 3], 2)
 * // => [1, 2]
 *
 * take([1, 2, 3], 5)
 * // => [1, 2, 3]
 *
 * take([1, 2, 3], 0)
 * // => []
 */
function take(array, n, guard) {
  if (!(array && array.length)) {
    return []
  }
  n = (guard || n === undefined) ? 1 : toInteger(n)
  return baseSlice(array, 0, n < 0 ? 0 : n)
}

export default take