package File
::Spec
::Win32
;
use vars
qw(@ISA $VERSION);
require File::Spec::Unix;
@ISA = qw(File::Spec::Unix);
File::Spec::Win32 - methods for Win32 file specs
require File::Spec::Win32; # Done internally by File::Spec if needed
See File::Spec::Unix for a documentation of the methods provided
there. This package overrides the implementation of these methods, not
Returns a string representation of the null device.
Returns a string representation of the first existing directory
The SYS:/temp is preferred in Novell NetWare.
Since Perl 5.8.0, if running under taint mode, and if the environment
variables are tainted, they are not used.
return $tmpdir if defined $tmpdir;
my @dirlist = (@ENV{qw(TMPDIR TEMP TMP)}, qw(C:/temp /tmp /));
if (${"\cTAINT"}) { # Check for taint mode on perl >= 5.8.0
@dirlist = grep { ! Scalar
::Util
::tainted
$_ } @dirlist;
next unless defined && -d
;
$tmpdir = '' unless defined $tmpdir;
$tmpdir = $self->canonpath($tmpdir);
sub file_name_is_absolute
{
return scalar($file =~ m{^([a-z]:)?[\\/]}is);
Concatenate one or more directory names and a filename to form a
complete path ending with a filename
my $dir = $self->catdir(@_);
$dir .= "\\" unless substr($dir,-1) eq "\\";
my $path = $ENV{'PATH'} || $ENV{'Path'} || $ENV{'path'};
my @path = split(';',$path);
foreach (@path) { $_ = '.' if $_ eq '' }
No physical check on the filesystem, but a logical cleanup of a
path. On UNIX eliminated successive slashes and successive "/.".
$path =~ s/^([a-z]:)/\u$1/s;
$path =~ s
|([^\\])\\+|$1\\|g
; # xx\\\\xx -> xx\xx
$path =~ s
|(\\\
.)+\\|\\|g
; # xx\.\.\xx -> xx\xx
$path =~ s
|^(\
.\\)+||s
unless $path eq ".\\"; # .\xx -> xx
unless $path =~ m
#^([A-Z]:)?\\\Z(?!\n)#s; # xx\ -> xx
($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 L</catpath> to get back a path equivalent to
(usually identical to) the original path.
my ($self,$path, $nofile) = @_;
my ($volume,$directory,$file) = ('','','');
m
{^( (?
:[a
-zA
-Z
]:|(?
:\\\\|//)[^\\/]+[\\/][^\\/]+)?
)
(?
:\\\\|//)[^\\/]+[\\/][^\\/]+
( (?
:.*[\\\\/](?
:\
.\
.?\Z
(?
!\n))?
)?
)
return ($volume,$directory,$file);
The opposite of L<catdir()|File::Spec/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
Unlike just splitting the directories on the separator, leading empty and
trailing directory entries can be returned, because these are significant
File::Spec->splitdir( "/a/b/c" );
( '', 'a', 'b', '', 'c', '' )
my ($self,$directories) = @_ ;
# split() likes to forget about trailing null fields, so here we
# check to be sure that there will not be any before handling the
if ( $directories !~ m
|[\\/]\Z
(?
!\n)| ) {
return split( m
|[\\/]|, $directories );
# since there was a trailing separator, add a file name to the end,
# then do the split, then replace it with ''.
my( @directories )= split( m
|[\\/]|, "${directories}dummy" ) ;
$directories[ $#directories ]= '' ;
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.
my ($self,$volume,$directory,$file) = @_;
# If it's UNC, make sure the glue separator is there, reusing
# whatever separator is first in the $volume
if ( $volume =~ m@
^([\\/])[\\/][^\\/]+[\\/][^\\/]+\Z
(?
!\n)@s &&
$directory =~ m@
^[^\\/]@s
# If the volume is not just A:, make sure the glue separator is
# there, reusing whatever separator is first in the $volume if possible.
if ( $volume !~ m@
^[a
-zA
-Z
]:\Z
(?
!\n)@s &&
$volume =~ m@
[^\\/]\Z
(?
!\n)@
&&
my $sep = $1 ?
$1 : '\\' ;
my($self,$path,$base) = @_;
if ( ! $self->file_name_is_absolute( $path ) ) {
$path = $self->rel2abs( $path ) ;
$path = $self->canonpath( $path ) ;
# Figure out the effective $base and clean it up.
if ( !defined( $base ) || $base eq '' ) {
elsif ( ! $self->file_name_is_absolute( $base ) ) {
$base = $self->rel2abs( $base ) ;
$base = $self->canonpath( $base ) ;
my ( undef, $path_directories, $path_file ) =
$self->splitpath( $path, 1 ) ;
my $base_directories = ($self->splitpath( $base, 1 ))[1] ;
# Now, remove all leading components that are the same
my @pathchunks = $self->splitdir( $path_directories );
my @basechunks = $self->splitdir( $base_directories );
lc( $pathchunks[0] ) eq lc( $basechunks[0] )
# No need to catdir, we know these are well formed.
$path_directories = CORE
::join( '\\', @pathchunks );
$base_directories = CORE
::join( '\\', @basechunks );
# $base_directories now contains the directories the resulting relative
# path must ascend out of before it can descend to $path_directory. So,
# replace all names with $parentDir
#FA Need to replace between backslashes...
$base_directories =~ s
|[^\\]+|..|g
;
# Glue the two together, using a separator if necessary, and preventing an
#FA Must check that new directories are not empty.
if ( $path_directories ne '' && $base_directories ne '' ) {
$path_directories = "$base_directories\\$path_directories" ;
$path_directories = "$base_directories$path_directories" ;
$self->catpath( "", $path_directories, $path_file )
my ($self,$path,$base ) = @_;
if ( ! $self->file_name_is_absolute( $path ) ) {
if ( !defined( $base ) || $base eq '' ) {
elsif ( ! $self->file_name_is_absolute( $base ) ) {
$base = $self->rel2abs( $base ) ;
$base = $self->canonpath( $base ) ;
my ( $path_directories, $path_file ) =
($self->splitpath( $path, 1 ))[1,2] ;
my ( $base_volume, $base_directories ) =
$self->splitpath( $base, 1 ) ;
$self->catdir( $base_directories, $path_directories ),
return $self->canonpath( $path ) ;
=head2 Note For File::Spec::Win32 Maintainers
Novell NetWare inherits its File::Spec behaviour from File::Spec::Win32.