Files
lodash/nth.js
John-David Dalton 764eccfdc0 Bump to v4.11.0.
2016-04-13 10:21:06 -07:00

30 lines
654 B
JavaScript

import baseNth from './_baseNth';
import toInteger from './toInteger';
/**
* Gets the nth element of `array`. If `n` is negative, the nth element
* from the end is returned.
*
* @static
* @memberOf _
* @since 4.11.0
* @category Array
* @param {Array} array The array to query.
* @param {number} [n=0] The index of the element to return.
* @returns {*} Returns the nth element of `array`.
* @example
*
* var array = ['a', 'b', 'c', 'd'];
*
* _.nth(array, 1);
* // => 'b'
*
* _.nth(array, -2);
* // => 'c';
*/
function nth(array, n) {
return (array && array.length) ? baseNth(array, toInteger(n)) : undefined;
}
export default nth;