External module "iter/concat/docs/types/index.d"

Export assignment iterConcat

• iterConcat(iter0: Iterator, iter1: Iterator, ...iterN: Array<Iterator>): Iterator

• Returns an iterator which iterates over the values of two or more iterators.

  Notes

  • If an environment supports Symbol.iterator and all provided iterators are iterable, the returned iterator is iterable.

  Parameters

  • iter0: Iterator

    first iterator

  • iter1: Iterator

    second iterator

  • Rest ...iterN: Array<Iterator>

    subsequent iterators

  Returns Iterator

  iterator

  Example

  var array2iterator = require( `@stdlib/array/to-iterator` );
  
  var it1 = array2iterator( [ 1, 2 ] );
  var it2 = array2iterator( [ 3, 4 ] );
  
  var iter = iterConcat( it1, it2 );
  
  var v = iter.next().value;
  // returns 1
  
  v = iter.next().value;
  // returns 2
  
  v = iter.next().value;
  // returns 3
  
  v = iter.next().value;
  // returns 4
  
  var bool = iter.next().done;
  // returns true