File::Spec::Win32PerlrProgrammers ReferenFile::Spec::Win32(2)



NAME
       File::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 "catpath" to get back a
           path equivalent to (usually identical to) the original
           path.

       splitdir
           The opposite of "catdir()".

               @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
       File::Spec



perl v5.6.1                 2001-03-20   File::Spec::Win32(2)