Filename | C:/tmp64ng/perl/lib/File/Spec/Unix.pm |
Statements | Executed 33 statements in 15.6ms |
Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
---|---|---|---|---|---|
1 | 1 | 1 | 15.6ms | 15.6ms | BEGIN@127 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@136 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@145 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@179 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@220 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@242 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@3 | File::Spec::Unix::
1 | 1 | 1 | 0s | 0s | BEGIN@4 | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _cache_tmpdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _cached_tmpdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _collapse | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _cwd | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _pp_canonpath | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _pp_catdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _pp_catfile | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _same | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | _tmpdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | abs2rel | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | case_tolerant | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | catpath | File::Spec::Unix::
6 | 4 | 4 | 0s | 0s | curdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | devnull | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | file_name_is_absolute | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | join | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | no_upwards | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | path | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | rel2abs | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | rootdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | splitdir | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | splitpath | File::Spec::Unix::
0 | 0 | 0 | 0s | 0s | tmpdir | File::Spec::Unix::
2 | 2 | 2 | 0s | 0s | updir | File::Spec::Unix::
Line | State ments |
Time on line |
Calls | Time in subs |
Code |
---|---|---|---|---|---|
1 | package File::Spec::Unix; | ||||
2 | |||||
3 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@3 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 3 # spent 0s making 1 call to File::Spec::Unix::BEGIN@3
# spent 0s making 1 call to strict::import |
4 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@4 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 4 # spent 0s making 1 call to File::Spec::Unix::BEGIN@4
# spent 0s making 1 call to vars::import |
5 | |||||
6 | 1 | 0s | $VERSION = '3.48_01'; | ||
7 | 1 | 0s | my $xs_version = $VERSION; | ||
8 | 1 | 0s | $VERSION =~ tr/_//; | ||
9 | |||||
10 | 1 | 0s | unless (defined &canonpath) { | ||
11 | eval { | ||||
12 | if ( $] >= 5.006 ) { | ||||
13 | require XSLoader; | ||||
14 | XSLoader::load("Cwd", $xs_version); | ||||
15 | } else { | ||||
16 | require Cwd; | ||||
17 | } | ||||
18 | }; | ||||
19 | } | ||||
20 | |||||
21 | =head1 NAME | ||||
22 | |||||
23 | File::Spec::Unix - File::Spec for Unix, base for other File::Spec modules | ||||
24 | |||||
25 | =head1 SYNOPSIS | ||||
26 | |||||
27 | require File::Spec::Unix; # Done automatically by File::Spec | ||||
28 | |||||
29 | =head1 DESCRIPTION | ||||
30 | |||||
31 | Methods for manipulating file specifications. Other File::Spec | ||||
32 | modules, such as File::Spec::Mac, inherit from File::Spec::Unix and | ||||
33 | override specific methods. | ||||
34 | |||||
35 | =head1 METHODS | ||||
36 | |||||
37 | =over 2 | ||||
38 | |||||
39 | =item canonpath() | ||||
40 | |||||
41 | No physical check on the filesystem, but a logical cleanup of a | ||||
42 | path. On UNIX eliminates successive slashes and successive "/.". | ||||
43 | |||||
44 | $cpath = File::Spec->canonpath( $path ) ; | ||||
45 | |||||
46 | Note that this does *not* collapse F<x/../y> sections into F<y>. This | ||||
47 | is by design. If F</foo> on your system is a symlink to F</bar/baz>, | ||||
48 | then F</foo/../quux> is actually F</bar/quux>, not F</quux> as a naive | ||||
49 | F<../>-removal would give you. If you want to do this kind of | ||||
50 | processing, you probably want C<Cwd>'s C<realpath()> function to | ||||
51 | actually traverse the filesystem cleaning up paths like this. | ||||
52 | |||||
53 | =cut | ||||
54 | |||||
55 | sub _pp_canonpath { | ||||
56 | my ($self,$path) = @_; | ||||
57 | return unless defined $path; | ||||
58 | |||||
59 | # Handle POSIX-style node names beginning with double slash (qnx, nto) | ||||
60 | # (POSIX says: "a pathname that begins with two successive slashes | ||||
61 | # may be interpreted in an implementation-defined manner, although | ||||
62 | # more than two leading slashes shall be treated as a single slash.") | ||||
63 | my $node = ''; | ||||
64 | my $double_slashes_special = $^O eq 'qnx' || $^O eq 'nto'; | ||||
65 | |||||
66 | |||||
67 | if ( $double_slashes_special | ||||
68 | && ( $path =~ s{^(//[^/]+)/?\z}{}s || $path =~ s{^(//[^/]+)/}{/}s ) ) { | ||||
69 | $node = $1; | ||||
70 | } | ||||
71 | # This used to be | ||||
72 | # $path =~ s|/+|/|g unless ($^O eq 'cygwin'); | ||||
73 | # but that made tests 29, 30, 35, 46, and 213 (as of #13272) to fail | ||||
74 | # (Mainly because trailing "" directories didn't get stripped). | ||||
75 | # Why would cygwin avoid collapsing multiple slashes into one? --jhi | ||||
76 | $path =~ s|/{2,}|/|g; # xx////xx -> xx/xx | ||||
77 | $path =~ s{(?:/\.)+(?:/|\z)}{/}g; # xx/././xx -> xx/xx | ||||
78 | $path =~ s|^(?:\./)+||s unless $path eq "./"; # ./xx -> xx | ||||
79 | $path =~ s|^/(?:\.\./)+|/|; # /../../xx -> xx | ||||
80 | $path =~ s|^/\.\.$|/|; # /.. -> / | ||||
81 | $path =~ s|/\z|| unless $path eq "/"; # xx/ -> xx | ||||
82 | return "$node$path"; | ||||
83 | } | ||||
84 | 1 | 0s | *canonpath = \&_pp_canonpath unless defined &canonpath; | ||
85 | |||||
86 | =item catdir() | ||||
87 | |||||
88 | Concatenate two or more directory names to form a complete path ending | ||||
89 | with a directory. But remove the trailing slash from the resulting | ||||
90 | string, because it doesn't look good, isn't necessary and confuses | ||||
91 | OS2. Of course, if this is the root directory, don't cut off the | ||||
92 | trailing slash :-) | ||||
93 | |||||
94 | =cut | ||||
95 | |||||
96 | sub _pp_catdir { | ||||
97 | my $self = shift; | ||||
98 | |||||
99 | $self->canonpath(join('/', @_, '')); # '' because need a trailing '/' | ||||
100 | } | ||||
101 | 1 | 0s | *catdir = \&_pp_catdir unless defined &catdir; | ||
102 | |||||
103 | =item catfile | ||||
104 | |||||
105 | Concatenate one or more directory names and a filename to form a | ||||
106 | complete path ending with a filename | ||||
107 | |||||
108 | =cut | ||||
109 | |||||
110 | sub _pp_catfile { | ||||
111 | my $self = shift; | ||||
112 | my $file = $self->canonpath(pop @_); | ||||
113 | return $file unless @_; | ||||
114 | my $dir = $self->catdir(@_); | ||||
115 | $dir .= "/" unless substr($dir,-1) eq "/"; | ||||
116 | return $dir.$file; | ||||
117 | } | ||||
118 | 1 | 0s | *catfile = \&_pp_catfile unless defined &catfile; | ||
119 | |||||
120 | =item curdir | ||||
121 | |||||
122 | Returns a string representation of the current directory. "." on UNIX. | ||||
123 | |||||
124 | =cut | ||||
125 | |||||
126 | 6 | 0s | # spent 0s within File::Spec::Unix::curdir which was called 6 times, avg 0s/call:
# 3 times (0s+0s) by ExtUtils::MakeMaker::check_hints at line 1024 of ExtUtils/MakeMaker.pm, avg 0s/call
# once (0s+0s) by main::BEGIN@1 at line 100 of ExtUtils/MM_Unix.pm
# once (0s+0s) by main::BEGIN@1 at line 19 of ExtUtils/MM_Any.pm
# once (0s+0s) by ExtUtils::Manifest::BEGIN@7 at line 1105 of File/Find.pm | ||
127 | 2 | 15.6ms | 2 | 15.6ms | # spent 15.6ms within File::Spec::Unix::BEGIN@127 which was called:
# once (15.6ms+0s) by File::Path::BEGIN@8 at line 127 # spent 15.6ms making 1 call to File::Spec::Unix::BEGIN@127
# spent 0s making 1 call to constant::import |
128 | |||||
129 | =item devnull | ||||
130 | |||||
131 | Returns a string representation of the null device. "/dev/null" on UNIX. | ||||
132 | |||||
133 | =cut | ||||
134 | |||||
135 | sub devnull { '/dev/null' } | ||||
136 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@136 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 136 # spent 0s making 1 call to File::Spec::Unix::BEGIN@136
# spent 0s making 1 call to constant::import |
137 | |||||
138 | =item rootdir | ||||
139 | |||||
140 | Returns a string representation of the root directory. "/" on UNIX. | ||||
141 | |||||
142 | =cut | ||||
143 | |||||
144 | sub rootdir { '/' } | ||||
145 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@145 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 145 # spent 0s making 1 call to File::Spec::Unix::BEGIN@145
# spent 0s making 1 call to constant::import |
146 | |||||
147 | =item tmpdir | ||||
148 | |||||
149 | Returns a string representation of the first writable directory from | ||||
150 | the following list or the current directory if none from the list are | ||||
151 | writable: | ||||
152 | |||||
153 | $ENV{TMPDIR} | ||||
154 | /tmp | ||||
155 | |||||
156 | If running under taint mode, and if $ENV{TMPDIR} | ||||
157 | is tainted, it is not used. | ||||
158 | |||||
159 | =cut | ||||
160 | |||||
161 | 1 | 0s | my ($tmpdir, %tmpenv); | ||
162 | # Cache and return the calculated tmpdir, recording which env vars | ||||
163 | # determined it. | ||||
164 | sub _cache_tmpdir { | ||||
165 | @tmpenv{@_[2..$#_]} = @ENV{@_[2..$#_]}; | ||||
166 | return $tmpdir = $_[1]; | ||||
167 | } | ||||
168 | # Retrieve the cached tmpdir, checking first whether relevant env vars have | ||||
169 | # changed and invalidated the cache. | ||||
170 | sub _cached_tmpdir { | ||||
171 | shift; | ||||
172 | local $^W; | ||||
173 | return if grep $ENV{$_} ne $tmpenv{$_}, @_; | ||||
174 | return $tmpdir; | ||||
175 | } | ||||
176 | sub _tmpdir { | ||||
177 | my $self = shift; | ||||
178 | my @dirlist = @_; | ||||
179 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@179 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 179 # spent 0s making 1 call to File::Spec::Unix::BEGIN@179
# spent 0s making 1 call to strict::unimport |
180 | if ($taint) { # Check for taint mode on perl >= 5.8.0 | ||||
181 | require Scalar::Util; | ||||
182 | @dirlist = grep { ! Scalar::Util::tainted($_) } @dirlist; | ||||
183 | } | ||||
184 | elsif ($] < 5.007) { # No ${^TAINT} before 5.8 | ||||
185 | @dirlist = grep { eval { eval('1'.substr $_,0,0) } } @dirlist; | ||||
186 | } | ||||
187 | |||||
188 | foreach (@dirlist) { | ||||
189 | next unless defined && -d && -w _; | ||||
190 | $tmpdir = $_; | ||||
191 | last; | ||||
192 | } | ||||
193 | $tmpdir = $self->curdir unless defined $tmpdir; | ||||
194 | $tmpdir = defined $tmpdir && $self->canonpath($tmpdir); | ||||
195 | if ( !$self->file_name_is_absolute($tmpdir) ) { | ||||
196 | # See [perl #120593] for the full details | ||||
197 | # If possible, return a full path, rather than '.' or 'lib', but | ||||
198 | # jump through some hoops to avoid returning a tainted value. | ||||
199 | ($tmpdir) = grep { | ||||
200 | $taint ? ! Scalar::Util::tainted($_) : | ||||
201 | $] < 5.007 ? eval { eval('1'.substr $_,0,0) } : 1 | ||||
202 | } $self->rel2abs($tmpdir), $tmpdir; | ||||
203 | } | ||||
204 | return $tmpdir; | ||||
205 | } | ||||
206 | |||||
207 | sub tmpdir { | ||||
208 | my $cached = $_[0]->_cached_tmpdir('TMPDIR'); | ||||
209 | return $cached if defined $cached; | ||||
210 | $_[0]->_cache_tmpdir($_[0]->_tmpdir( $ENV{TMPDIR}, "/tmp" ), 'TMPDIR'); | ||||
211 | } | ||||
212 | |||||
213 | =item updir | ||||
214 | |||||
215 | Returns a string representation of the parent directory. ".." on UNIX. | ||||
216 | |||||
217 | =cut | ||||
218 | |||||
219 | 2 | 0s | # spent 0s within File::Spec::Unix::updir which was called 2 times, avg 0s/call:
# once (0s+0s) by main::BEGIN@1 at line 102 of ExtUtils/MM_Unix.pm
# once (0s+0s) by main::BEGIN@1 at line 21 of ExtUtils/MM_Any.pm | ||
220 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@220 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 220 # spent 0s making 1 call to File::Spec::Unix::BEGIN@220
# spent 0s making 1 call to constant::import |
221 | |||||
222 | =item no_upwards | ||||
223 | |||||
224 | Given a list of file names, strip out those that refer to a parent | ||||
225 | directory. (Does not strip symlinks, only '.', '..', and equivalents.) | ||||
226 | |||||
227 | =cut | ||||
228 | |||||
229 | sub no_upwards { | ||||
230 | my $self = shift; | ||||
231 | return grep(!/^\.{1,2}\z/s, @_); | ||||
232 | } | ||||
233 | |||||
234 | =item case_tolerant | ||||
235 | |||||
236 | Returns a true or false value indicating, respectively, that alphabetic | ||||
237 | is not or is significant when comparing file specifications. | ||||
238 | |||||
239 | =cut | ||||
240 | |||||
241 | sub case_tolerant { 0 } | ||||
242 | 2 | 0s | 2 | 0s | # spent 0s within File::Spec::Unix::BEGIN@242 which was called:
# once (0s+0s) by File::Path::BEGIN@8 at line 242 # spent 0s making 1 call to File::Spec::Unix::BEGIN@242
# spent 0s making 1 call to constant::import |
243 | |||||
244 | =item file_name_is_absolute | ||||
245 | |||||
246 | Takes as argument a path and returns true if it is an absolute path. | ||||
247 | |||||
248 | This does not consult the local filesystem on Unix, Win32, OS/2 or Mac | ||||
249 | OS (Classic). It does consult the working environment for VMS (see | ||||
250 | L<File::Spec::VMS/file_name_is_absolute>). | ||||
251 | |||||
252 | =cut | ||||
253 | |||||
254 | sub file_name_is_absolute { | ||||
255 | my ($self,$file) = @_; | ||||
256 | return scalar($file =~ m:^/:s); | ||||
257 | } | ||||
258 | |||||
259 | =item path | ||||
260 | |||||
261 | Takes no argument, returns the environment variable PATH as an array. | ||||
262 | |||||
263 | =cut | ||||
264 | |||||
265 | sub path { | ||||
266 | return () unless exists $ENV{PATH}; | ||||
267 | my @path = split(':', $ENV{PATH}); | ||||
268 | foreach (@path) { $_ = '.' if $_ eq '' } | ||||
269 | return @path; | ||||
270 | } | ||||
271 | |||||
272 | =item join | ||||
273 | |||||
274 | join is the same as catfile. | ||||
275 | |||||
276 | =cut | ||||
277 | |||||
278 | sub join { | ||||
279 | my $self = shift; | ||||
280 | return $self->catfile(@_); | ||||
281 | } | ||||
282 | |||||
283 | =item splitpath | ||||
284 | |||||
285 | ($volume,$directories,$file) = File::Spec->splitpath( $path ); | ||||
286 | ($volume,$directories,$file) = File::Spec->splitpath( $path, | ||||
287 | $no_file ); | ||||
288 | |||||
289 | Splits a path into volume, directory, and filename portions. On systems | ||||
290 | with no concept of volume, returns '' for volume. | ||||
291 | |||||
292 | For systems with no syntax differentiating filenames from directories, | ||||
293 | assumes that the last file is a path unless $no_file is true or a | ||||
294 | trailing separator or /. or /.. is present. On Unix this means that $no_file | ||||
295 | true makes this return ( '', $path, '' ). | ||||
296 | |||||
297 | The directory portion may or may not be returned with a trailing '/'. | ||||
298 | |||||
299 | The results can be passed to L</catpath()> to get back a path equivalent to | ||||
300 | (usually identical to) the original path. | ||||
301 | |||||
302 | =cut | ||||
303 | |||||
304 | sub splitpath { | ||||
305 | my ($self,$path, $nofile) = @_; | ||||
306 | |||||
307 | my ($volume,$directory,$file) = ('','',''); | ||||
308 | |||||
309 | if ( $nofile ) { | ||||
310 | $directory = $path; | ||||
311 | } | ||||
312 | else { | ||||
313 | $path =~ m|^ ( (?: .* / (?: \.\.?\z )? )? ) ([^/]*) |xs; | ||||
314 | $directory = $1; | ||||
315 | $file = $2; | ||||
316 | } | ||||
317 | |||||
318 | return ($volume,$directory,$file); | ||||
319 | } | ||||
320 | |||||
321 | |||||
322 | =item splitdir | ||||
323 | |||||
324 | The opposite of L</catdir()>. | ||||
325 | |||||
326 | @dirs = File::Spec->splitdir( $directories ); | ||||
327 | |||||
328 | $directories must be only the directory portion of the path on systems | ||||
329 | that have the concept of a volume or that have path syntax that differentiates | ||||
330 | files from directories. | ||||
331 | |||||
332 | Unlike just splitting the directories on the separator, empty | ||||
333 | directory names (C<''>) can be returned, because these are significant | ||||
334 | on some OSs. | ||||
335 | |||||
336 | On Unix, | ||||
337 | |||||
338 | File::Spec->splitdir( "/a/b//c/" ); | ||||
339 | |||||
340 | Yields: | ||||
341 | |||||
342 | ( '', 'a', 'b', '', 'c', '' ) | ||||
343 | |||||
344 | =cut | ||||
345 | |||||
346 | sub splitdir { | ||||
347 | return split m|/|, $_[1], -1; # Preserve trailing fields | ||||
348 | } | ||||
349 | |||||
350 | |||||
351 | =item catpath() | ||||
352 | |||||
353 | Takes volume, directory and file portions and returns an entire path. Under | ||||
354 | Unix, $volume is ignored, and directory and file are concatenated. A '/' is | ||||
355 | inserted if needed (though if the directory portion doesn't start with | ||||
356 | '/' it is not added). On other OSs, $volume is significant. | ||||
357 | |||||
358 | =cut | ||||
359 | |||||
360 | sub catpath { | ||||
361 | my ($self,$volume,$directory,$file) = @_; | ||||
362 | |||||
363 | if ( $directory ne '' && | ||||
364 | $file ne '' && | ||||
365 | substr( $directory, -1 ) ne '/' && | ||||
366 | substr( $file, 0, 1 ) ne '/' | ||||
367 | ) { | ||||
368 | $directory .= "/$file" ; | ||||
369 | } | ||||
370 | else { | ||||
371 | $directory .= $file ; | ||||
372 | } | ||||
373 | |||||
374 | return $directory ; | ||||
375 | } | ||||
376 | |||||
377 | =item abs2rel | ||||
378 | |||||
379 | Takes a destination path and an optional base path returns a relative path | ||||
380 | from the base path to the destination path: | ||||
381 | |||||
382 | $rel_path = File::Spec->abs2rel( $path ) ; | ||||
383 | $rel_path = File::Spec->abs2rel( $path, $base ) ; | ||||
384 | |||||
385 | If $base is not present or '', then L<cwd()|Cwd> is used. If $base is | ||||
386 | relative, then it is converted to absolute form using | ||||
387 | L</rel2abs()>. This means that it is taken to be relative to | ||||
388 | L<cwd()|Cwd>. | ||||
389 | |||||
390 | On systems that have a grammar that indicates filenames, this ignores the | ||||
391 | $base filename. Otherwise all path components are assumed to be | ||||
392 | directories. | ||||
393 | |||||
394 | If $path is relative, it is converted to absolute form using L</rel2abs()>. | ||||
395 | This means that it is taken to be relative to L<cwd()|Cwd>. | ||||
396 | |||||
397 | No checks against the filesystem are made, so the result may not be correct if | ||||
398 | C<$base> contains symbolic links. (Apply | ||||
399 | L<Cwd::abs_path()|Cwd/abs_path> beforehand if that | ||||
400 | is a concern.) On VMS, there is interaction with the working environment, as | ||||
401 | logicals and macros are expanded. | ||||
402 | |||||
403 | Based on code written by Shigio Yamaguchi. | ||||
404 | |||||
405 | =cut | ||||
406 | |||||
407 | sub abs2rel { | ||||
408 | my($self,$path,$base) = @_; | ||||
409 | $base = $self->_cwd() unless defined $base and length $base; | ||||
410 | |||||
411 | ($path, $base) = map $self->canonpath($_), $path, $base; | ||||
412 | |||||
413 | my $path_directories; | ||||
414 | my $base_directories; | ||||
415 | |||||
416 | if (grep $self->file_name_is_absolute($_), $path, $base) { | ||||
417 | ($path, $base) = map $self->rel2abs($_), $path, $base; | ||||
418 | |||||
419 | my ($path_volume) = $self->splitpath($path, 1); | ||||
420 | my ($base_volume) = $self->splitpath($base, 1); | ||||
421 | |||||
422 | # Can't relativize across volumes | ||||
423 | return $path unless $path_volume eq $base_volume; | ||||
424 | |||||
425 | $path_directories = ($self->splitpath($path, 1))[1]; | ||||
426 | $base_directories = ($self->splitpath($base, 1))[1]; | ||||
427 | |||||
428 | # For UNC paths, the user might give a volume like //foo/bar that | ||||
429 | # strictly speaking has no directory portion. Treat it as if it | ||||
430 | # had the root directory for that volume. | ||||
431 | if (!length($base_directories) and $self->file_name_is_absolute($base)) { | ||||
432 | $base_directories = $self->rootdir; | ||||
433 | } | ||||
434 | } | ||||
435 | else { | ||||
436 | my $wd= ($self->splitpath($self->_cwd(), 1))[1]; | ||||
437 | $path_directories = $self->catdir($wd, $path); | ||||
438 | $base_directories = $self->catdir($wd, $base); | ||||
439 | } | ||||
440 | |||||
441 | # Now, remove all leading components that are the same | ||||
442 | my @pathchunks = $self->splitdir( $path_directories ); | ||||
443 | my @basechunks = $self->splitdir( $base_directories ); | ||||
444 | |||||
445 | if ($base_directories eq $self->rootdir) { | ||||
446 | return $self->curdir if $path_directories eq $self->rootdir; | ||||
447 | shift @pathchunks; | ||||
448 | return $self->canonpath( $self->catpath('', $self->catdir( @pathchunks ), '') ); | ||||
449 | } | ||||
450 | |||||
451 | my @common; | ||||
452 | while (@pathchunks && @basechunks && $self->_same($pathchunks[0], $basechunks[0])) { | ||||
453 | push @common, shift @pathchunks ; | ||||
454 | shift @basechunks ; | ||||
455 | } | ||||
456 | return $self->curdir unless @pathchunks || @basechunks; | ||||
457 | |||||
458 | # @basechunks now contains the directories the resulting relative path | ||||
459 | # must ascend out of before it can descend to $path_directory. If there | ||||
460 | # are updir components, we must descend into the corresponding directories | ||||
461 | # (this only works if they are no symlinks). | ||||
462 | my @reverse_base; | ||||
463 | while( defined(my $dir= shift @basechunks) ) { | ||||
464 | if( $dir ne $self->updir ) { | ||||
465 | unshift @reverse_base, $self->updir; | ||||
466 | push @common, $dir; | ||||
467 | } | ||||
468 | elsif( @common ) { | ||||
469 | if( @reverse_base && $reverse_base[0] eq $self->updir ) { | ||||
470 | shift @reverse_base; | ||||
471 | pop @common; | ||||
472 | } | ||||
473 | else { | ||||
474 | unshift @reverse_base, pop @common; | ||||
475 | } | ||||
476 | } | ||||
477 | } | ||||
478 | my $result_dirs = $self->catdir( @reverse_base, @pathchunks ); | ||||
479 | return $self->canonpath( $self->catpath('', $result_dirs, '') ); | ||||
480 | } | ||||
481 | |||||
482 | sub _same { | ||||
483 | $_[1] eq $_[2]; | ||||
484 | } | ||||
485 | |||||
486 | =item rel2abs() | ||||
487 | |||||
488 | Converts a relative path to an absolute path. | ||||
489 | |||||
490 | $abs_path = File::Spec->rel2abs( $path ) ; | ||||
491 | $abs_path = File::Spec->rel2abs( $path, $base ) ; | ||||
492 | |||||
493 | If $base is not present or '', then L<cwd()|Cwd> is used. If $base is | ||||
494 | relative, then it is converted to absolute form using | ||||
495 | L</rel2abs()>. This means that it is taken to be relative to | ||||
496 | L<cwd()|Cwd>. | ||||
497 | |||||
498 | On systems that have a grammar that indicates filenames, this ignores | ||||
499 | the $base filename. Otherwise all path components are assumed to be | ||||
500 | directories. | ||||
501 | |||||
502 | If $path is absolute, it is cleaned up and returned using L</canonpath()>. | ||||
503 | |||||
504 | No checks against the filesystem are made. On VMS, there is | ||||
505 | interaction with the working environment, as logicals and | ||||
506 | macros are expanded. | ||||
507 | |||||
508 | Based on code written by Shigio Yamaguchi. | ||||
509 | |||||
510 | =cut | ||||
511 | |||||
512 | sub rel2abs { | ||||
513 | my ($self,$path,$base ) = @_; | ||||
514 | |||||
515 | # Clean up $path | ||||
516 | if ( ! $self->file_name_is_absolute( $path ) ) { | ||||
517 | # Figure out the effective $base and clean it up. | ||||
518 | if ( !defined( $base ) || $base eq '' ) { | ||||
519 | $base = $self->_cwd(); | ||||
520 | } | ||||
521 | elsif ( ! $self->file_name_is_absolute( $base ) ) { | ||||
522 | $base = $self->rel2abs( $base ) ; | ||||
523 | } | ||||
524 | else { | ||||
525 | $base = $self->canonpath( $base ) ; | ||||
526 | } | ||||
527 | |||||
528 | # Glom them together | ||||
529 | $path = $self->catdir( $base, $path ) ; | ||||
530 | } | ||||
531 | |||||
532 | return $self->canonpath( $path ) ; | ||||
533 | } | ||||
534 | |||||
535 | =back | ||||
536 | |||||
537 | =head1 COPYRIGHT | ||||
538 | |||||
539 | Copyright (c) 2004 by the Perl 5 Porters. All rights reserved. | ||||
540 | |||||
541 | This program is free software; you can redistribute it and/or modify | ||||
542 | it under the same terms as Perl itself. | ||||
543 | |||||
544 | Please submit bug reports and patches to perlbug@perl.org. | ||||
545 | |||||
546 | =head1 SEE ALSO | ||||
547 | |||||
548 | L<File::Spec> | ||||
549 | |||||
550 | =cut | ||||
551 | |||||
552 | # Internal routine to File::Spec, no point in making this public since | ||||
553 | # it is the standard Cwd interface. Most of the platform-specific | ||||
554 | # File::Spec subclasses use this. | ||||
555 | sub _cwd { | ||||
556 | require Cwd; | ||||
557 | Cwd::getcwd(); | ||||
558 | } | ||||
559 | |||||
560 | |||||
561 | # Internal method to reduce xx\..\yy -> yy | ||||
562 | sub _collapse { | ||||
563 | my($fs, $path) = @_; | ||||
564 | |||||
565 | my $updir = $fs->updir; | ||||
566 | my $curdir = $fs->curdir; | ||||
567 | |||||
568 | my($vol, $dirs, $file) = $fs->splitpath($path); | ||||
569 | my @dirs = $fs->splitdir($dirs); | ||||
570 | pop @dirs if @dirs && $dirs[-1] eq ''; | ||||
571 | |||||
572 | my @collapsed; | ||||
573 | foreach my $dir (@dirs) { | ||||
574 | if( $dir eq $updir and # if we have an updir | ||||
575 | @collapsed and # and something to collapse | ||||
576 | length $collapsed[-1] and # and its not the rootdir | ||||
577 | $collapsed[-1] ne $updir and # nor another updir | ||||
578 | $collapsed[-1] ne $curdir # nor the curdir | ||||
579 | ) | ||||
580 | { # then | ||||
581 | pop @collapsed; # collapse | ||||
582 | } | ||||
583 | else { # else | ||||
584 | push @collapsed, $dir; # just hang onto it | ||||
585 | } | ||||
586 | } | ||||
587 | |||||
588 | return $fs->catpath($vol, | ||||
589 | $fs->catdir(@collapsed), | ||||
590 | $file | ||||
591 | ); | ||||
592 | } | ||||
593 | |||||
594 | |||||
595 | 1 | 0s | 1; |