Method advance

output/java_guava/1.4.19/Iterators.java:910–919

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)

   */

  @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