last property

@override @Deprecated("Use next() instead. This consumes the first element of the iterator. Which is likely not the users intent.") T get last

The last element.

Throws a StateError if this is empty. Otherwise may iterate through the elements and returns the last one seen. Some iterables may have more efficient ways to find the last element (for example a list can directly access the last element, without iterating through the previous ones).

Implementation

@override
@Deprecated(
    "Use next() instead. This consumes the first element of the iterator. Which is likely not the users intent.")
T get last {
  assert(false,
      "Use next() instead. This consumes the first element of the iterator. Which is likely not the users intent.");
  return super.last;
}