/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the MIT License. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ export namespace Iterable { export function is(thing: any): thing is IterableIterator { return thing && typeof thing === 'object' && typeof thing[Symbol.iterator] === 'function'; } const _empty: Iterable = Object.freeze([]); export function empty(): Iterable { return _empty; } export function* single(element: T): Iterable { yield element; } export function from(iterable: Iterable | undefined | null): Iterable { return iterable || _empty; } export function isEmpty(iterable: Iterable | undefined | null): boolean { return !iterable || iterable[Symbol.iterator]().next().done === true; } export function first(iterable: Iterable): T | undefined { return iterable[Symbol.iterator]().next().value; } export function some(iterable: Iterable, predicate: (t: T) => boolean): boolean { for (const element of iterable) { if (predicate(element)) { return true; } } return false; } export function filter(iterable: Iterable, predicate: (t: T) => t is R): Iterable; export function filter(iterable: Iterable, predicate: (t: T) => boolean): Iterable; export function* filter(iterable: Iterable, predicate: (t: T) => boolean): Iterable { for (const element of iterable) { if (predicate(element)) { yield element; } } } export function* map(iterable: Iterable, fn: (t: T) => R): Iterable { for (const element of iterable) { yield fn(element); } } export function* concat(...iterables: Iterable[]): Iterable { for (const iterable of iterables) { for (const element of iterable) { yield element; } } } export function* concatNested(iterables: Iterable>): Iterable { for (const iterable of iterables) { for (const element of iterable) { yield element; } } } /** * Returns an iterable slice of the array, with the same semantics as `array.slice()`. */ export function* slice(iterable: ReadonlyArray, from: number, to = iterable.length): Iterable { if (from < 0) { from += iterable.length; } if (to < 0) { to += iterable.length; } else if (to > iterable.length) { to = iterable.length; } for (; from < to; from++) { yield iterable[from]; } } /** * Consumes `atMost` elements from iterable and returns the consumed elements, * and an iterable for the rest of the elements. */ export function consume(iterable: Iterable, atMost: number = Number.POSITIVE_INFINITY): [T[], Iterable] { const consumed: T[] = []; if (atMost === 0) { return [consumed, iterable]; } const iterator = iterable[Symbol.iterator](); for (let i = 0; i < atMost; i++) { const next = iterator.next(); if (next.done) { return [consumed, Iterable.empty()]; } consumed.push(next.value); } return [consumed, { [Symbol.iterator]() { return iterator; } }]; } }