CONTENTS

• NAME
• SYNOPSIS
• DESCRIPTION
• SEE ALSO
• AUTHORS

#NAME

File::Spec - portably perform operations on file names

#SYNOPSIS

use File::Spec;

$x=File::Spec->catfile('a','b','c');

which returns 'a/b/c' under Unix.

#DESCRIPTION

This module is designed to support operations commonly performed on file specifications (usually called "file names", but not to be confused with the contents of a file, or Perl's file handles), such as concatenating several directory and file names into a single path, or determining whether a path is rooted. It is based on code directly taken from MakeMaker 5.17, code written by Andreas König, Andy Dougherty, Charles Bailey, Ilya Zakharevich, Paul Schinder, and others.

Since these functions are different for most operating systems, each set of OS specific routines is available in a separate module, including:

File::Spec::Unix
File::Spec::Mac
File::Spec::OS2
File::Spec::Win32
File::Spec::VMS

The module appropriate for the current OS is automatically loaded by File::Spec. Since some modules (like VMS) make use of OS specific facilities, it may not be possible to load all modules under all operating systems.

Since File::Spec is object oriented, subroutines should not called directly, as in:

File::Spec::catfile('a','b');

but rather as class methods:

File::Spec->catfile('a','b');

For a reference of available functions, pleaes consult File::Spec::Unix, which contains the entire set, and inherited by the modules for other platforms. For further information, please see File::Spec::Mac, File::Spec::OS2, File::Spec::Win32, or File::Spec::VMS.

#SEE ALSO

File::Spec::Unix, File::Spec::Mac, File::Spec::OS2, File::Spec::Win32, File::Spec::VMS, ExtUtils::MakeMaker

#AUTHORS

Kenneth Albanowski <[email protected]>, Andy Dougherty <[email protected]>, Andreas König <[email protected]>, Tim Bunce <[email protected]>. VMS support by Charles Bailey <[email protected]>. OS/2 support by Ilya Zakharevich <[email protected]>. Mac support by Paul Schinder <[email protected]>.

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.