NAME

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

SYNOPSIS

 use Iterator::Locate;
 my $it = Iterator::Locate->new;
 until ($it->is_exhausted) {
   my $entry = $it->value;
   print $entry,"\n";
 }

CLASS HIERARCHY

Iterator::Locate is a subclass of Iterator,

    Iterator
      Iterator::Locate

DESCRIPTION

An Iterator::Locate object reads a "locate" database file in iterator style. It allows the various Iterator module features to be used for filtering or crunching entries from an underling File::Locate::Iterator.

See examples/iterator-pm.pl for a simple complete program.

FUNCTIONS

Creation

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

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

SEE ALSO

Iterator, 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/