file::find::wanted(3pm) [debian man page]

Wanted(3pm)						User Contributed Perl Documentation					       Wanted(3pm)

NAME

       File::Find::Wanted - More obvious wrapper around File::Find

VERSION

       Version 1.00

SYNOPSIS

       File::Find is a great module, except that it doesn't actually find anything.  Its "find()" function walks a directory tree and calls a
       callback function.  Unfortunately, the callback function is deceptively called "wanted", which implies that it should return a boolean
       saying whether you want the file.  That's not how it works.

       Most of the time you call "find()", you just want to build a list of files.  There are other modules that do this for you, most notably
       Richard Clamp's great File::Find::Rule, but in many cases, it's overkill, and you need to learn a new syntax.

       With the "find_wanted" function, you supply a callback sub and a list of starting directories, but the sub actually should return a boolean
       saying whether you want the file in your list or not.

       To get a list of all files ending in .jpg:

	   my @files = find_wanted( sub { -f && /.jpg$/ }, $dir );

       For a list of all directories that are not CVS or .svn:

	   my @files = find_wanted( sub { -d && !/^(CVS|.svn)$/ }, $dir ) );

       It's easy, direct, and simple.

WHY DO THIS
?
       The cynical may say "that's just the same as doing this":

	   my @files;
	   find( sub { push @files, $File::Find::name if -f && /.jpg$/ }, $dir );

       Sure it is, but File::Find::Wanted makes it more obvious, and saves a line of code.  That's worth it to me.  I'd like it if find_wanted()
       made its way into the File::Find distro, but for now, this will do.

FUNCTIONS

   find_wanted( &wanted, @directories )
       Descends through @directories, calling the wanted function as it finds each file.  The function returns a list of all the files and
       directories for which the wanted function returned a true value.

       This is just a wrapper around "File::Find::find()".  See File::Find for details on how to modify its behavior.

COPYRIGHT &; LICENSE
       Copyright 2005-2012 Andy Lester.

       This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License v2.0.

perl v5.14.2							    2012-06-08							       Wanted(3pm)

Check Out this Related Man Page

File::Find::Rule::Procedural(3pm)			User Contributed Perl Documentation			 File::Find::Rule::Procedural(3pm)

NAME

       File::Find::Rule::Procedural - File::Find::Rule's procedural interface

SYNOPSIS

	 use File::Find::Rule;

	 # find all .pm files, procedurally
	 my @files = find(file => name => '*.pm', in => @INC);

DESCRIPTION

       In addition to the regular object-oriented interface, File::Find::Rule provides two subroutines for you to use.

       "find( @clauses )"
       "rule( @clauses )"
	   "find" and "rule" can be used to invoke any methods available to the OO version.  "rule" is a synonym for "find"

       Passing more than one value to a clause is done with an anonymous array:

	my $finder = find( name => [ '*.mp3', '*.ogg' ] );

       "find" and "rule" both return a File::Find::Rule instance, unless one of the arguments is "in", in which case it returns a list of things
       that match the rule.

	my @files = find( name => [ '*.mp3', '*.ogg' ], in => $ENV{HOME} );

       Please note that "in" will be the last clause evaluated, and so this code will search for mp3s regardless of size.

	my @files = find( name => '*.mp3', in => $ENV{HOME}, size => '<2k' );
							   ^
							   |
		      Clause processing stopped here ------/

       It is also possible to invert a single rule by prefixing it with "!"  like so:

	# large files that aren't videos
	my @files = find( file	  =>
			  '!name' => [ '*.avi', '*.mov' ],
			  size	  => '>20M',
			  in	  => $ENV{HOME} );

AUTHOR

       Richard Clamp <richardc@unixbeard.net>

COPYRIGHT

       Copyright (C) 2003 Richard Clamp.  All Rights Reserved.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       File::Find::Rule

perl v5.12.4							    2011-09-19					 File::Find::Rule::Procedural(3pm)

Linux and UNIX Man Pages

file::find::wanted(3pm) [debian man page]

Check Out this Related Man Page