LibTest/core/Iterable/iterator_A01_t01.test.dart

// Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

/**
 * @assertion Iterator<E> iterator
 * Returns a new Iterator that allows iterating the elements of this Iterable.
 * Iterable classes may specify the iteration order of their elements (for
 * example List always iterate in index order), or they may leave it unspecified
 * (for example a hash-based Set may iterate in any order).
 *
 * Each time iterator is read, it returns a new iterator, which can be used to
 * iterate through all the elements again. The iterators of the same iterable
 * can be stepped through independently, but should return the same elements in
 * the same order, as long as the underlying collection isn't changed.
 *
 * Modifying the collection may cause new iterators to produce different
 * elements, and may change the order of existing elements. A List specifies its
 * iteration order precisely, so modifying the list changes the iteration order
 * predictably. A hash-based Set may change its iteration order completely when
 * adding a new element to the set.
 *
 * Modifying the underlying collection after creating the new iterator may cause
 * an error the next time Iterator.moveNext is called on that iterator. Any
 * modifiable iterable class should specify which operations will break
 * iteration.
 * @description Checks the returned [Iterator] properties and methods
 * list.
 * @author vasya
 */
library iterator_A01_t01;
 
import "../Iterator/allTests.lib.dart" as libIterator;

var createFunc;

Iterator createIterator([Iterable? content]) {
  return createFunc(content).iterator;
}

test(Iterable create([Iterable? content]), {bool isSet: false}) {
  createFunc = create;
  libIterator.test(createIterator, isSet: isSet);
}