51 lines
2.3 KiB
TypeScript
51 lines
2.3 KiB
TypeScript
import { ListIterateeCustom } from '../_internal/ListIterateeCustom.js';
|
|
import { ObjectIterateeCustom } from '../_internal/ObjectIteratee.js';
|
|
import { StringIterator } from '../_internal/StringIterator.js';
|
|
|
|
/**
|
|
* Iterates over the collection and rejects elements based on the given predicate.
|
|
* If a function is provided, it is invoked for each element in the collection.
|
|
*
|
|
* @param {string | null | undefined} collection The string to iterate over
|
|
* @param {StringIterator<boolean>} [predicate] The function invoked per iteration
|
|
* @returns {string[]} Returns a new array of characters that do not satisfy the predicate
|
|
* @example
|
|
* reject('abc', char => char === 'b')
|
|
* // => ['a', 'c']
|
|
*/
|
|
declare function reject(collection: string | null | undefined, predicate?: StringIterator<boolean>): string[];
|
|
/**
|
|
* Iterates over the collection and rejects elements based on the given predicate.
|
|
* If a function is provided, it is invoked for each element in the collection.
|
|
*
|
|
* @template T
|
|
* @param {ArrayLike<T> | null | undefined} collection The array-like to iterate over
|
|
* @param {ListIterateeCustom<T, boolean>} [predicate] The function invoked per iteration
|
|
* @returns {T[]} Returns a new array of elements that do not satisfy the predicate
|
|
* @example
|
|
* reject([1, 2, 3], num => num % 2 === 0)
|
|
* // => [1, 3]
|
|
*
|
|
* reject([{ a: 1 }, { a: 2 }, { b: 1 }], 'a')
|
|
* // => [{ b: 1 }]
|
|
*/
|
|
declare function reject<T>(collection: ArrayLike<T> | null | undefined, predicate?: ListIterateeCustom<T, boolean>): T[];
|
|
/**
|
|
* Iterates over the collection and rejects elements based on the given predicate.
|
|
* If a function is provided, it is invoked for each element in the collection.
|
|
*
|
|
* @template T
|
|
* @param {T | null | undefined} collection The object to iterate over
|
|
* @param {ObjectIterateeCustom<T, boolean>} [predicate] The function invoked per iteration
|
|
* @returns {Array<T[keyof T]>} Returns a new array of elements that do not satisfy the predicate
|
|
* @example
|
|
* reject({ a: 1, b: 2, c: 3 }, value => value % 2 === 0)
|
|
* // => [1, 3]
|
|
*
|
|
* reject({ item1: { a: 0, b: true }, item2: { a: 1, b: true }, item3: { a: 2, b: false }}, { b: false })
|
|
* // => [{ a: 0, b: true }, { a: 1, b: true }]
|
|
*/
|
|
declare function reject<T extends object>(collection: T | null | undefined, predicate?: ObjectIterateeCustom<T, boolean>): Array<T[keyof T]>;
|
|
|
|
export { reject };
|