Страницы справочника OS X

Эта страница руководства для  версии 10.9 Mac OS X

Читать страницы руководства

Find(3)                              User Contributed Perl Documentation                             Find(3)



NAME
       Module::Find - Find and use installed modules in a (sub)category

SYNOPSIS
         use Module::Find;

         # use all modules in the Plugins/ directory
         @found = usesub Mysoft::Plugins;

         # use modules in all subdirectories
         @found = useall Mysoft::Plugins;

         # find all DBI::... modules
         @found = findsubmod DBI;

         # find anything in the CGI/ directory
         @found = findallmod CGI;

         # set your own search dirs (uses @INC otherwise)
         setmoduledirs(@INC, @plugindirs, $appdir);

         # not exported by default
         use Module::Find qw(ignoresymlinks followsymlinks);

         # ignore symlinks
         ignoresymlinks();

         # follow symlinks (default)
         followsymlinks();

DESCRIPTION
       Module::Find lets you find and use modules in categories. This can be very useful for auto-detecting
       driver or plugin modules. You can differentiate between looking in the category itself or in all
       subcategories.

       If you want Module::Find to search in a certain directory on your harddisk (such as the plugins
       directory of your software installation), make sure you modify @INC before you call the Module::Find
       functions.

FUNCTIONS
       "setmoduledirs(@directories)"
           Sets the directories to be searched for modules. If not set, Module::Find will use @INC. If you
           use this function, @INC will not be included automatically, so add it if you want it. Set to
           undef to revert to default behaviour.

       "@found = findsubmod Module::Category"
           Returns modules found in the Module/Category subdirectories of your perl installation. E.g.
           "findsubmod CGI" will return "CGI::Session", but not "CGI::Session::File" .

       "@found = findallmod Module::Category"
           Returns modules found in the Module/Category subdirectories of your perl installation. E.g.
           "findallmod CGI" will return "CGI::Session" and also "CGI::Session::File" .

       "@found = usesub Module::Category"
           Uses and returns modules found in the Module/Category subdirectories of your perl installation.
           E.g. "usesub CGI" will return "CGI::Session", but not "CGI::Session::File" .

       "@found = useall Module::Category"
           Uses and returns modules found in the Module/Category subdirectories of your perl installation.
           E.g. "useall CGI" will return "CGI::Session" and also "CGI::Session::File" .

       "ignoresymlinks()"
           Do not follow symlinks. This function is not exported by default.

       "followsymlinks()"
           Follow symlinks (default behaviour). This function is not exported by default.

HISTORY
       0.01, 2004-04-22
               Original version; created by h2xs 1.22

       0.02, 2004-05-25
               Added test modules that were left out in the first version. Thanks to Stuart Johnston for
               alerting me to this.

       0.03, 2004-06-18
               Fixed a bug (non-localized $_) by declaring a loop variable in use functions.  Thanks to
               Stuart Johnston for alerting me to this and providing a fix.

               Fixed non-platform compatibility by using File::Spec.  Thanks to brian d foy.

               Added setmoduledirs and updated tests. Idea shamelessly stolen from ...errm... inspired by
               brian d foy.

       0.04, 2005-05-20
               Added POD tests.

       0.05, 2005-11-30
               Fixed issue with bugfix in PathTools-3.14.

       0.06, 2008-01-26
               Module::Find now won't report duplicate modules several times anymore (thanks to Uwe Voelker
               for the report and the patch)

       0.07, 2009-09-08
               Fixed RT#38302: Module::Find now follows symlinks by default (can be disabled).

       0.08, 2009-09-08
               Fixed RT#49511: Removed Mac OS X extended attributes from distribution

       0.09, 2010-02-26
               Fixed RT#38302: Fixed META.yml generation (thanks very much to cpanservice for the help).

       0.10, 2010-02-26
               Fixed RT#55010: Removed Unicode BOM from Find.pm.

       0.11, 2012-05-22
               Fixed RT#74251: defined(@array) is deprecated under Perl 5.15.7.

DEVELOPMENT NOTES
       Please report any bugs using the CPAN RT system. The development repository for this module is hosted
       on GitHub: http://github.com/crenz/Module-Find/ <http://github.com/crenz/Module-Find/>.

SEE ALSO
       perl

AUTHOR
       Christian Renz, <crenz@web42.com>

COPYRIGHT AND LICENSE
       Copyright 2004-2012 by Christian Renz <crenz@web42.com>. All rights reserved.

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



perl v5.16.2                                     2012-05-21                                          Find(3)