NAME

WWW::AUR::Iterator - An iterator for looping through all AUR packages.

SYNOPSIS

my $iter = $aurobj->packages;
# or my $iter = WWW::AUR::Iterator->new();

while ( my $pkg = $iter->next ) {
    print $pkg->name, "\n";
}

$iter->reset;
while ( my $pkgname = $iter->next_name ) {
    print "$pkgname\n";
}

DESCRIPTION

A WWW::AUR::Iterator object can be used to iterate through all packages currently listed on the AUR webiste.

CONSTRUCTOR

$OBJ = WWW::AUR::Iterator->new( %PATH_PARAMS );
%PATH_PARAMS

The parameters are the same as the WWW::AUR constructor. These are propogated to any WWW::AUR::Package objects that are created.

$OBJ

A WWW::AUR::Iterator object.

METHODS

reset

$OBJ->reset;

The iterator is reset to the beginning of all packages available in the AUR. This starts the iteration over just like creating a new WWW::AUR::Iterator object.

next

$PKGOBJ | undef = $OBJ->next();
$PKGOBJ

A WWW::AUR::Package object representing the next package in the AUR.

undef

If we have iterated through all packages, then undef is returned.

next_name

$PKGNAME | undef = $OBJ->next_name();
$PKGNAME

The name of the next package in the AUR. This is faster than "next" because WWW::AUR::Package objects do not have to be created for every package on the AUR.

undef

If we have iterated through all packages, then undef is returned.

SEE ALSO

WWW::AUR

AUTHOR

Justin Davis, <juster at cpan dot org>

BUGS

Please email me any bugs you find. I will try to fix them as quick as I can.

SUPPORT

Send me an email if you have any questions or need help.

LICENSE AND COPYRIGHT

Copyright 2011 Justin Davis.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.