$iter = ipermute (@list); $array_ref = $iter->value();
Permutes the items in an arbitrary list. Each time the iterator is called, it returns the next combination of the items, in the form of a reference to an array.
$iter = inth ($n, $another_iterator);
Returns an iterator to return every nth value from the input iterator. The first $n-1 items are skipped, then one is returned, then the next $n-1 items are skipped, and so on.
This can be useful for sampling data.
$iter = irand_nth ($n, $another_iterator);
Random nth. Returns an iterator to return items from the input iterator, with a probability of 1/$n for each. On average, in the long run, 1 of every $n items will be returned.
This can be useful for random sampling of data.
$iter = ifibonacci (); $iter = ifibonacci ($start); $iter = ifibonacci ($start1, $start2);
Generates a Fibonacci sequence. If starting values are not specified, uses (1, 1). If only one is specified, it is used for both starting values.
$iter = igeometric ($start, $end, $multiplier)
Generates a geometric sequence. If $end is undefined, the sequence is unbounded.
All function names are exported to the callers namespace by default.
Iterator::Misc uses Exception::Class objects for throwing exceptions. If youre not familiar with Exception::Class, dont worry; these exception objects work just like $@ does with die and croak, but they are easier to work with if you are trapping errors.
For more information on how to handle these exception objects, see the Iterator documentation.
o Parameter Errors
As a string, this exception provides a human-readable message about what the problem was.
o Exhausted Iterators
You called value on an iterator that is exhausted; that is, there are no more values in the sequence to return.
As a string, this exception is Iterator is exhausted.
o User Code Exceptions
This exception is thrown when the sequence generation code throws any sort of error besides Am_Now_Exhausted. This could be because your code explicitly threw an error (that is, died), or because it otherwise encountered an exception (any runtime error).
This exception has one method, eval_error, which returns the original $@ that was trapped by the Iterator object. This may be a string or an object, depending on how die was invoked.
As a string, this exception evaluates to the stringified $@.
o Internal Errors
Something happened that I thought couldnt possibly happen. I would appreciate it if you could send me an email message detailing the circumstances of the error.
Requires the following additional modules:
Higher Order Perl, Mark Jason Dominus, Morgan Kauffman 2005.
Much thanks to Will Coleda and Paul Lalli (and the RPI lily crowd in general) for suggestions for the pre-release version.
Eric J. Roode, firstname.lastname@example.org
Copyright (c) 2005 by Eric J. Roode. All Rights Reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To avoid my spam filter, please include Perl, module, or this modules name in the messages subject line, and/or GPG-sign your message.
|perl v5.20.3||MISC (3)||2005-08-26|