NAME

Iterator::Simple::Locate -- read "locate" database with Iterator::Simple

SYNOPSIS

use Iterator::Simple::Locate;
my $it = Iterator::Simple::Locate->new;
while (defined (my $entry = $it->())) {
  print $entry,"\n";
}

DESCRIPTION

Iterator::Simple::Locate reads a "locate" database file in iterator style. It allows the various Iterator::Simple features to be used to filter or crunch entries from the locate database read by an underlying File::Locate::Iterator.

See examples/iterator-simple.pl for a simple complete program and examples/mini-locate.pl for a bigger program.

FUNCTIONS

$it = Iterator::Simple::Locate->new (key=>value,...)

Create and return a new Iterator::Simple object. Optional key/value pairs as passed to File::Locate::Iterator->new().

$entry = $it->()

Return the next entry from the database, or return undef when no more entries.

SEE ALSO

Iterator::Simple, File::Locate::Iterator

HOME PAGE

http://user42.tuxfamily.org/file-locate-iterator/index.html

COPYRIGHT

Copyright 2009, 2010, 2011, 2014, 2017, 2018, 2019 Kevin Ryde

File-Locate-Iterator is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

File-Locate-Iterator is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with File-Locate-Iterator. If not, see http://www.gnu.org/licenses/