You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
41 lines
1.2 KiB
JavaScript
41 lines
1.2 KiB
JavaScript
9 years ago
|
var baseAt = require('../internal/baseAt'),
|
||
|
|
baseCompareAscending = require('../internal/baseCompareAscending'),
|
||
|
|
baseFlatten = require('../internal/baseFlatten'),
|
||
|
|
basePullAt = require('../internal/basePullAt'),
|
||
|
|
restParam = require('../function/restParam');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Removes elements from `array` corresponding to the given indexes and returns
|
||
|
|
* an array of the removed elements. Indexes may be specified as an array of
|
||
|
|
* indexes or as individual arguments.
|
||
|
|
*
|
||
|
|
* **Note:** Unlike `_.at`, this method mutates `array`.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @category Array
|
||
|
|
* @param {Array} array The array to modify.
|
||
|
|
* @param {...(number|number[])} [indexes] The indexes of elements to remove,
|
||
|
|
* specified as individual indexes or arrays of indexes.
|
||
|
|
* @returns {Array} Returns the new array of removed elements.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* var array = [5, 10, 15, 20];
|
||
|
|
* var evens = _.pullAt(array, 1, 3);
|
||
|
|
*
|
||
|
|
* console.log(array);
|
||
|
|
* // => [5, 15]
|
||
|
|
*
|
||
|
|
* console.log(evens);
|
||
|
|
* // => [10, 20]
|
||
|
|
*/
|
||
|
|
var pullAt = restParam(function(array, indexes) {
|
||
|
|
indexes = baseFlatten(indexes);
|
||
|
|
|
||
|
|
var result = baseAt(array, indexes);
|
||
|
|
basePullAt(array, indexes.sort(baseCompareAscending));
|
||
|
|
return result;
|
||
|
|
});
|
||
|
|
|
||
|
|
module.exports = pullAt;
|