UNPKG

@newdash/newdash

Version:

javascript/typescript utility library

31 lines (30 loc) 1 kB
import { CollectionIteratee } from "./types"; /** * Removes all elements from `array` that `predicate` returns truthy for * and returns an array of the removed elements. The predicate is invoked * with three arguments: (value, index, array). * * **Note:** Unlike `filter`, this method mutates `array`. Use `pull` * to pull elements from an array by value. * * @since 5.11.0 * @category Array * @param {Array} array The array to modify. * @param {Function} predicate The function invoked per iteration. * @returns {Array} Returns the new array of removed elements. * @see [[pull]], [[pullAll]], [[pullAllBy]], [[pullAllWith]], [[pullAt]], [[reject]], [[filter]] * @example * * ```js * const array = [1, 2, 3, 4] * const evens = remove(array, n => n % 2 == 0) * * console.log(array) * // => [1, 3] * * console.log(evens) * // => [2, 4] * ``` */ export declare function remove<T>(array: ArrayLike<T>, predicate: CollectionIteratee<T, boolean>): Array<T>; export default remove;