Jan Krynicky > Win32-AbsPath > Win32::AbsPath

Download:
Win32-AbsPath-1.0.tar.gz

Dependencies

Annotate this POD

Related Modules

Win32::API
File::Which
File::Spec
Win32::FileOp
C::DynaLib
more...
By perlmonks.org

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 1.0   Source  

NAME ^

Win32::AbsPath - convert relative to absolute paths

Version 1.0

SYNOPSIS ^

 use Win32::AbsPath;
 $path = Win32::AbsPath::Fix '../some\dir\file.doc'
 system("winword $path");

 use Win32::AbsPath qw(Relative2Absolute);
 @paths = qw(
  ..\dir\file.txt
  ./other.doc
  c:\boot.ini
 );
 Relative2Absolute @paths;

DESCRIPTION ^

Convert relative paths to absolute. Understands UNC paths.

The functions understands many different types of paths

    dir\file.txt
    ..\dir\file.txt
    c:\dir\file.txt
    c:\dir\..\file.txt
    \dir\file.txt
    \\server\share\dir\..\file.txt
    c:dir\file.txt

and of course you may pepper these with whatever mixtures of \.\ and \..\ you like. You may use both forward and backward slashes, the result will be in backward slashes.

! The ussage of paths of type c:file.txt is slightly deprecated. It IS supported, but may lead to a change of current directory. The function first chdir()s top the current directory on the drive mentioned in the path and then back to cwd() in time it was called. If any of those chdir()s fails, the result of the function will be undef.

This is likely to happen if one of the drives is a floppy or CD, or if one of the drives was a network drive and was disconnected.

Functions ^

Relative2Absolute
 Relative2Absolute @list;

Converts all paths in @list to absolute paths in-place. That is the function changes the list you pass in.

RelativeToAbsolute
 $abspath = RelativeToAbsolute $relpath;

Converts the relative path to absolute. Returns the absolute path, but doesn't change the parameter. It takes exactly one parameter!

 print join(' ',RelativeToAbsolute '_file.txt','_other.txt');
    prints
 c:\_file.txt _other.txt
    instead of
 c:\_file.txt c:\_other.txt
Win32::AbsPath::Fix $path

The same as RelativeToAbsolute.

AUTHOR

<Jenda@Krynicky.cz> and Mike <blazer@mail.nevalink.ru>

syntax highlighting: