use vars
qw(@ISA $VERSION);
require File::Spec::Unix;
@ISA = qw(File::Spec::Unix);
sub file_name_is_absolute
{
return scalar($file =~ m{^([a-z]:)?[\\/]}is);
my @path = split(';',$path);
foreach (@path) { $_ = '.' if $_ eq '' }
return $tmpdir if defined $tmpdir;
my @dirlist = ( @ENV{qw(TMPDIR TEMP TMP)}, qw(/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);
No physical check on the filesystem, but a logical cleanup of a
path. On UNIX eliminated successive slashes and successive "/.".
$path =~ s/^([a-z]:)/\l$1/s;
$path =~ s
|([^/])/+|$1/|g; # xx////xx -> xx/xx
$path =~ s
|(/\.)+/|/|g; # xx/././xx -> xx
/xx
$path =~ s
|^(\
./)+(?=[^/])||s
; # ./xx -> xx
unless $path =~ m
#^([a-z]:)?/\Z(?!\n)#si;# 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 m
|[\\/]|, $directories, -1;
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 ) ;
File::Spec::OS2 - methods for OS/2 file specs
require File::Spec::OS2; # 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