dropWhile (Iterator)

当谓词成立时,惰性地跳过迭代器的前导元素,然后产生其余元素。

const rest = dropWhile(source, shouldDrop);

用法

dropWhile(source, shouldDrop)

当你想根据条件而不是固定数量来跳过开头的一段元素时,请使用 dropWhile——例如,跳过日志行直到第一条错误为止。只要 shouldDrop 返回真值,元素就会被跳过;从第一个不满足条件的元素起(包括该元素在内)的所有元素都会被产出。原生迭代器辅助方法提供了基于数量的 drop,但没有基于谓词的 dropWhile,这正是提供此函数的原因。

import { dropWhile } from 'es-toolkit/iterator';

// 跳过开头连续的小数字。
dropWhile([1, 2, 3, 1].values(), x => x < 3).toArray();
// 返回: [3, 1]

// 一旦第一个元素就不满足谓词,则不会跳过任何元素。
dropWhile([5, 1, 2].values(), x => x < 3).toArray();
// 返回: [5, 1, 2]

参数

• source (Iterator<T>): 要跳过元素的迭代器。
• shouldDrop ((value: T, index: number) => boolean): 以每个元素及其索引调用;只要它返回真值,元素就会被跳过。

返回值

(IteratorObject<T, undefined>): 一个惰性迭代器,产生被跳过的前导部分之后的元素。它带有所有原生迭代器辅助方法(map、take、toArray 等),可以继续链式调用。