Method advance

corpus/java/training/guava/collect/Iterators.java:859–869

Calls next() on iterator, either numberToAdvance times or until hasNext() returns false, whichever comes first. @return the number of elements the iterator was advanced @since 13.0 (since 3.0 as Iterators.skip)

(Iterator<?> iterator, int numberToAdvance)

   * @since 13.0 (since 3.0 as {@code Iterators.skip})
   */
  @CanIgnoreReturnValue
  public static int advance(Iterator<?> iterator, int numberToAdvance) {
    checkNotNull(iterator);
    checkArgument(numberToAdvance >= 0, "numberToAdvance must be nonnegative");

    int i;
    for (i = 0; i < numberToAdvance && iterator.hasNext(); i++) {
      iterator.next();
    }
    return i;
  }

  /**
   * Returns a view containing the first {@code limitSize} elements of {@code