dropRightWhile
从数组末尾移除元素,直到谓词函数返回 false
。
该函数迭代数组,并从末尾开始移除元素,直到提供的谓词函数返回 false
为止。然后返回剩余元素组成的新数组。
签名
typescript
function dropRightWhile<T>(arr: T[], canContinueDropping: (item: T, index: number, arr: T[]) => boolean): T[];
参数
arr
(T[]
): 要从中移除元素的数组。canContinueDropping
((item: T, index: number, arr: T[]) => boolean
): 一个谓词函数,用于确定是否继续移除元素。该函数将对数组中的每个元素调用,只要返回true
,移除操作就会继续。
返回值
(T[]
) 谓词函数返回 false
后剩余的元素组成的新数组。
示例
typescript
const array = [1, 2, 3, 4, 5];
const result = dropRightWhile(array, x => x > 3);
// 结果将是 [1, 2, 3] 因为大于 3 的元素从末尾被移除了。
Lodash 兼容性
从 es-toolkit/compat
导入 dropRightWhile
以实现与 lodash 的完全兼容。
您可以指定移除元素的条件,只要该条件评估为 true,数组将从末尾移除项目。
- 谓词函数:您可以提供一个谓词函数,该函数将应用于数组中的每个项目。该函数应返回
true
,以指示应移除的元素。移除操作将持续进行,直到谓词第一次返回false
。 - 部分对象:您还可以提供一个部分对象,只要其属性与提供的对象的属性匹配,函数就会从数组中移除元素。
- 属性-值对:或者,您可以指定一个属性-值对,函数将移除具有指定属性且与给定值匹配的元素。
- 属性名:最后,您可以提供一个属性名,函数将从数组中移除元素,直到找到一个指定属性为真值的元素。
签名
typescript
function dropRightWhile<T>(
arr: ArrayLike<T> | null | undefined,
canContinueDropping: (item: T, index: number, arr: T[]) => unknown
): T[];
function dropRightWhile<T>(arr: ArrayLike<T> | null | undefined, objectToDrop: Partial<T>): T[];
function dropRightWhile<T>(arr: ArrayLike<T> | null | undefined, propertyToDrop: [keyof T, unknown]): T[];
function dropRightWhile<T>(arr: ArrayLike<T> | null | undefined, propertyToDrop: PropertyKey): T[];
示例
typescript
// 使用谓词函数的示例
const array1 = [5, 4, 3, 2, 1];
const result1 = dropRightWhile(array1, x => x < 3);
// result1 将是 [5, 4, 3],因为小于 3 的元素被移除了。
// 使用部分对象的示例
const array2 = [{ a: 1 }, { a: 2 }, { a: 3 }];
const result2 = dropRightWhile(array2, { a: 3 });
// result2 将是 [{ a: 1 }, { a: 2 }],因为最后一个对象与提供的对象的属性匹配。
// 使用属性-值对的示例
const array3 = [{ id: 1 }, { id: 2 }, { id: 3 }];
const result3 = dropRightWhile(array3, ['id', 3]);
// result3 将是 [{ id: 1 }, { id: 2 }],因为最后一个对象的 id 属性与值 3 匹配。
// 使用属性名的示例
const array4 = [{ isActive: false }, { isActive: true }, { isActive: true }];
const result4 = dropRightWhile(array4, 'isActive');
// result4 将是 [{ isActive: false }],因为它会移除元素,直到找到一个 isActive 属性为假值的元素。