1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
package File::Spec::Unix;
use Exporter ();
use Config;
use File::Basename qw(basename dirname fileparse);
use DirHandle;
use strict;
use vars qw(@ISA $Is_Mac $Is_OS2 $Is_VMS $Is_Win32);
use File::Spec;
Exporter::import('File::Spec', '$Verbose');
$Is_OS2 = $^O eq 'os2';
$Is_Mac = $^O eq 'MacOS';
$Is_Win32 = $^O eq 'MSWin32';
if ($Is_VMS = $^O eq 'VMS') {
require VMS::Filespec;
import VMS::Filespec qw( &vmsify );
}
=head1 NAME
File::Spec::Unix - methods used by File::Spec
=head1 SYNOPSIS
C<require File::Spec::Unix;>
=head1 DESCRIPTION
Methods for manipulating file specifications.
=head1 METHODS
=over 2
=item canonpath
No physical check on the filesystem, but a logical cleanup of a
path. On UNIX eliminated successive slashes and successive "/.".
=cut
sub canonpath {
my($self,$path) = @_;
$path =~ s|/+|/|g ; # xx////xx -> xx/xx
$path =~ s|(/\.)+/|/|g ; # xx/././xx -> xx/xx
$path =~ s|^(\./)+|| unless $path eq "./"; # ./xx -> xx
$path =~ s|/$|| unless $path eq "/"; # xx/ -> xx
$path;
}
=item catdir
Concatenate two or more directory names to form a complete path ending
with a directory. But remove the trailing slash from the resulting
string, because it doesn't look good, isn't necessary and confuses
OS2. Of course, if this is the root directory, don't cut off the
trailing slash :-)
=cut
# ';
sub catdir {
shift;
my @args = @_;
for (@args) {
# append a slash to each argument unless it has one there
$_ .= "/" if $_ eq '' or substr($_,-1) ne "/";
}
my $result = join('', @args);
# remove a trailing slash unless we are root
substr($result,-1) = ""
if length($result) > 1 && substr($result,-1) eq "/";
$result;
}
=item catfile
Concatenate one or more directory names and a filename to form a
complete path ending with a filename
=cut
sub catfile {
my $self = shift @_;
my $file = pop @_;
return $file unless @_;
my $dir = $self->catdir(@_);
for ($dir) {
$_ .= "/" unless substr($_,length($_)-1,1) eq "/";
}
return $dir.$file;
}
=item curdir
Returns a string representing of the current directory. "." on UNIX.
=cut
sub curdir {
return "." ;
}
=item rootdir
Returns a string representing of the root directory. "/" on UNIX.
=cut
sub rootdir {
return "/";
}
=item updir
Returns a string representing of the parent directory. ".." on UNIX.
=cut
sub updir {
return "..";
}
=item no_upwards
Given a list of file names, strip out those that refer to a parent
directory. (Does not strip symlinks, only '.', '..', and equivalents.)
=cut
sub no_upwards {
my($self) = shift;
return grep(!/^\.{1,2}$/, @_);
}
=item file_name_is_absolute
Takes as argument a path and returns true, if it is an absolute path.
=cut
sub file_name_is_absolute {
my($self,$file) = @_;
$file =~ m:^/: ;
}
=item path
Takes no argument, returns the environment variable PATH as an array.
=cut
sub path {
my($self) = @_;
my $path_sep = ":";
my $path = $ENV{PATH};
my @path = split $path_sep, $path;
foreach(@path) { $_ = '.' if $_ eq '' }
@path;
}
=item join
join is the same as catfile.
=cut
sub join {
my($self) = shift @_;
$self->catfile(@_);
}
=item nativename
TBW.
=cut
sub nativename {
my($self,$name) = shift @_;
$name;
}
=back
=head1 SEE ALSO
L<File::Spec>
=cut
1;
__END__
|
