| Name : perl-Iterator
| |
| Version : 0.03
| Vendor : obs://build_opensuse_org/devel:languages:perl
|
| Release : lp154.1.1
| Date : 2023-01-27 16:41:15
|
| Group : Development/Libraries/Perl
| Source RPM : perl-Iterator-0.03-lp154.1.1.src.rpm
|
| Size : 0.04 MB
| |
| Packager : https://www_suse_com/
| |
| Summary : General-Purpose Iterator Class
|
Description :
This module is meant to be the definitive implementation of iterators, as
popularized by Mark Jason Dominus\'s lectures and recent book (_Higher Order
Perl_, Morgan Kauffman, 2005).
An \"iterator\" is an object, represented as a code block that generates the
\"next value\" of a sequence, and generally implemented as a closure. When
you need a value to operate on, you pull it from the iterator. If it
depends on other iterators, it pulls values from them when it needs to.
Iterators can be chained together (see Iterator::Util for functions that
help you do just that), queueing up work to be done but _not actually doing
it_ until a value is needed at the front end of the chain. At that time,
one data value is pulled through the chain.
Contrast this with ordinary array processing, where you load or compute all
of the input values at once, then loop over them in memory. It\'s analogous
to the difference between looping over a file one line at a time, and
reading the entire file into an array of lines before operating on it.
Iterator.pm provides a class that simplifies creation and use of these
iterator objects. Other \'Iterator::\' modules (see \"SEE ALSO\") provide many
general-purpose and special-purpose iterator functions.
Some iterators are infinite (that is, they generate infinite sequences),
and some are finite. When the end of a finite sequence is reached, the
iterator code block should throw an exception of the type
\'Iterator::X::Am_Now_Exhausted\'; this is usually done via the is_done
function.. This will signal the Iterator class to mark the object as
exhausted. The is_exhausted method will then return true, and the
isnt_exhausted method will return false. Any further calls to the value
method will throw an exception of the type \'Iterator::X::Exhausted\'. See
DIAGNOSTICS.
Note that in many, many cases, you will not need to explicitly create an
iterator; there are plenty of iterator generation and manipulation
functions in the other associated modules. You can just plug them together
like building blocks.
|
RPM found in directory: /packages/linux-pbone/ftp5.gwdg.de/pub/opensuse/repositories/devel:/languages:/perl:/CPAN-I/15.4/noarch |
