File::Find::Object::Result(3pm) User Contributed Perl Documentation File::Find::Object::Result(3pm)NAME
File::Find::Object::Result - a result class for File::Find::Object
DESCRIPTION
This is a class returning a single File::Find::Object result as returned by its next_obj() method.
METHODS
File::Find::Object::Result->new({%args});
Initializes a new object from %args. For internal use.
$result->base()
Returns the base directory from which searching began.
$result->path()
Returns the full path of the result. As such "$ffo->next_obj()->path()" is equivalent to "$ffo->next()" .
$result->is_dir()
Returns true if the result refers to a directory.
$result->is_file()
Returns true if the result refers to a plain file (equivalent to the Perl "-f" operator).
$result->is_link()
Returns true if the result is a symbolic link.
$result->dir_components()
The components of the directory part of the path starting from base() (also the full path if the result is a directory) as an array
reference.
$result->basename()
Returns the basename of the file (if it is a file and not a directory.) Otherwise - undef().
$result->full_components()
Returns the full components of the result with the basename if it is a file.
$result->stat_ret()
The return value of "stat" in perlfunc for the result, placed inside an array reference. This is calculated by File::Find::Object and kept
here for convenience and for internal use.
SEE ALSO
File::Find::Object
LICENSE
Copyright (C) 2005, 2006 by Olivier Thauvin
This package is free software; you can redistribute it and/or modify it under the following terms:
1. The GNU General Public License Version 2.0 - http://www.opensource.org/licenses/gpl-license.php
2. The Artistic License Version 2.0 - http://www.perlfoundation.org/legal/licenses/artistic-2_0.html
3. At your option - any later version of either or both of these licenses.
perl v5.10.0 2009-06-18 File::Find::Object::Result(3pm)
Check Out this Related Man Page
FINDORULE(1p) User Contributed Perl Documentation FINDORULE(1p)NAME
findorule - command line wrapper to File::Find::Object::Rule
USAGE
findorule [path...] [expression]
DESCRIPTION
"findorule" mostly borrows the interface from GNU find(1) to provide a command-line interface onto the File::Find::Object::Rule heirarchy
of modules.
The syntax for expressions is the rule name, preceded by a dash, followed by an optional argument. If the argument is an opening
parenthesis it is taken as a list of arguments, terminated by a closing parenthesis.
Some examples:
find -file -name ( foo bar )
files named "foo" or "bar", below the current directory.
find -file -name foo -bar
files named "foo", that have pubs (for this is what our ficticious "bar" clause specifies), below the current directory.
find -file -name ( -bar )
files named "-bar", below the current directory. In this case if we'd have omitted the parenthesis it would have parsed as a call to name
with no arguments, followed by a call to -bar.
Supported switches
I'm very slack. Please consult the File::Find::Object::Rule manpage for now, and prepend - to the commands that you want.
Extra bonus switches
findorule automatically loads all of your installed File::Find::Object::Rule::* extension modules, so check the documentation to see what
those would be.
AUTHOR
Richard Clamp <richardc@unixbeard.net> from a suggestion by Tatsuhiko Miyagawa
Adapted to File::Find::Object::Rule by Shlomi Fish (all copyrights disclaimed).
COPYRIGHT
Copyright (C) 2002 Richard Clamp. All Rights Reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
File::Find::Object::Rule
perl v5.14.2 2012-05-05 FINDORULE(1p)