Documentation for method skip-at-least-pull-one

Documentation for method skip-at-least-pull-one, assembled from the following types:

role Iterator

From Iterator

(Iterator) method skip-at-least-pull-one

Defined as:

method skip-at-least-pull-one(Iterator:D: $targetint $to-skip --> Mu)

Skips $to-skip values and pulls the next value. The returns the pulled value or IterationEnd if there were not enough values:

my $i = <a b c>.iterator;
say $i.skip-at-least-pull-one(2);
say $i.skip-at-least-pull-one(20=:= IterationEnd;
# OUTPUT: «c␤True␤»