Files
lodash/nth.js
John-David Dalton 63ba93dcb3 Bump to v4.11.0.
2016-04-13 10:23:46 -07:00

30 lines
662 B
JavaScript

var baseNth = require('./_baseNth'),
toInteger = require('./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;
}
module.exports = nth;