NAME
FastGlob - A faster glob() implementation
VERSION
version 1.6
SYNOPSIS
use FastGlob qw(glob);
my @list = glob('*.c');
DESCRIPTION
This module implements globbing in perl, rather than forking a csh. This is faster than the built-in glob() call, and more robust (on many platforms, csh chokes on echo * if too many files are in the directory.)
There are several module-local variables that control platform-specific behavior. On Windows ($^O eq 'MSWin32'), these are automatically set to appropriate values. On other platforms, UNIX defaults are used. You can override them after loading the module if needed.
# UNIX defaults (auto-detected):
$FastGlob::dirsep = '/'; # directory path separator
$FastGlob::rootpat = '\A\Z'; # root directory prefix pattern
$FastGlob::curdir = '.'; # name of current directory in dir
$FastGlob::parentdir = '..'; # name of parent directory in dir
$FastGlob::hidedotfiles = 1; # hide filenames starting with .
# Windows defaults (auto-detected on MSWin32):
$FastGlob::dirsep = '\\'; # directory path separator
$FastGlob::rootpat = '[A-Za-z]:'; # <Drive letter><colon> pattern
$FastGlob::curdir = '.'; # name of current directory in dir
$FastGlob::parentdir = '..'; # name of parent directory in dir
$FastGlob::hidedotfiles = 1; # hide filenames starting with .
For classic MacOS you would set:
$FastGlob::dirsep = ':'; # directory path separator
$FastGlob::rootpat = '\A\Z'; # root directory prefix pattern
$FastGlob::curdir = '.'; # name of current directory in dir
$FastGlob::parentdir = '..'; # name of parent directory in dir
$FastGlob::hidedotfiles = 0; # hide filenames starting with .
Tilde expansion (~ and ~user) uses getpwuid/getpwnam on UNIX. On Windows, ~ falls back to $HOME or $USERPROFILE.
INSTALLATION
Copy this module to the Perl 5 Library directory.
AUTHOR
Marc Mengel <mengel@fnal.gov>
COPYRIGHT AND LICENSE
This software is copyright (c) 1999 by Marc Mengel.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.