File::Spec::Win32Perl Programmers Reference GFile::Spec::Win32(3)NAMEFile::Spec::Win32 - methods for Win32 file specs
SYNOPSIS
require File::Spec::Win32; # Done internally by File::Spec if needed
DESCRIPTION
See File::Spec::Unix for a documentation of the methods
provided there. This package overrides the implementation
of these methods, not the semantics.
devnull
Returns a string representation of the null device.
tmpdir
Returns a string representation of the first existing
directory from the following list:
$ENV{TMPDIR}
$ENV{TEMP}
$ENV{TMP}
C:/temp
/tmp
/
catfile
Concatenate one or more directory names and a filename
to form a complete path ending with a filename
canonpath
No physical check on the filesystem, but a logical
cleanup of a path. On UNIX eliminated successive
slashes and successive "/.".
splitpath
($volume,$directories,$file) = File::Spec->splitpath( $path );
($volume,$directories,$file) = File::Spec->splitpath( $path, $no_file );
Splits a path in to volume, directory, and filename
portions. Assumes that the last file is a path unless
the path ends in '\\', '\\.', '\\..' or $no_file is
true. On Win32 this means that $no_file true makes
this return ( $volume, $path, undef ).
Separators accepted are \ and /.
Volumes can be drive letters or UNC sharenames
(\\server\share).
The results can be passed to the catpath entry else
where in this document to get back a path equivalent
to (usually identical to) the original path.
splitdir
The opposite of the catdir() entry elsewhere in this
document.
@dirs = File::Spec->splitdir( $directories );
$directories must be only the directory portion of the
path on systems that have the concept of a volume or
that have path syntax that differentiates files from
directories.
Unlike just splitting the directories on the separa
tor, leading empty and trailing directory entries can
be returned, because these are significant on some
OSs. So,
File::Spec->splitdir( "/a/b/c" );
Yields:
( '', 'a', 'b', '', 'c', '' )
catpath
Takes volume, directory and file portions and returns
an entire path. Under Unix, $volume is ignored, and
this is just like catfile(). On other OSs, the $volume
become significant.
SEE ALSO
the File::Spec manpage
2001-03-03 perl v5.6.1 File::Spec::Win32(3)