Class::PObject::Iterator - Incremental object loader for Class::PObject
use Class::PObject::Iterator; my $iter = new Class::PObject::Iterator($class, \@ids); while ( my $obj = $iter->fetch ) { ... }
Class::PObject::Iterator is a stand-alone iterator class initially used by Class::PObject when you call fetch() method on a pobject.
fetch()
new($class, \@ids)
Constructor method. Accepts two arguments - name of the class, and list of ids. Returns Class::PObject::Iterator object. You normally never will have to call new() yourself, because when you call fetch() method on your $pobject it will return pre-initialized iterator object.
new()
next()
When called on an iterator object, it will return the next object from the stack. Remember, it will not return the object id, but it will return fully initialized pobject.
size()
Returns size of the current stack. This number decrements by one each time next() is called, to reflect how many more elements are left in the data set.
reset()
Resets the internal data set pointer to the beginning of the data set. This means, no matter how far you have been into the stack, after you call reset(), the next time you call next() method, it will return the object from the beginning of the stack.
push($idx)
Pushes a new object id to the end of the current stack.
finish()
Clears up the stack and other related data from the object. finish() will be called for you automatically once the iterator object exits the scope. You normally will not need to call this method, for iterator object clears up all the remaining stack before it exits its scope. However, this method may be handy if you are planning to push() more data sets to the iterator object and want to start from clean data set:
push()
$iterator->finish(); for ( @inx ) { $iterator->push($_) }
Class::PObject
For author and copyright information refer to Class::PObject's online manual.
To install Class::PObject, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Class::PObject
CPAN shell
perl -MCPAN -e shell install Class::PObject
For more information on module installation, please visit the detailed CPAN module installation guide.