MAN page from Old RedHat 5.X perl-5.004-4.i386.rpm

Cwd

Section: Perl Programmers Reference Guide (3)
Updated: perl 5.004, patch 04
Index

NAME

getcwd - get pathname of current working directory

SYNOPSIS

    use Cwd;    $dir = cwd;

    use Cwd;    $dir = getcwd;

    use Cwd;    $dir = fastgetcwd;

    use Cwd 'chdir';    chdir "/tmp";    print $ENV{'PWD'};

DESCRIPTION

The getcwd() function re-implements the getcwd(3) (or getwd(3)) functionsin Perl.

The fastcwd() function looks the same as getcwd(), but runs faster.It's also more dangerous because it might conceivably chdir() you outof a directory that it can't chdir() you back into. If fastcwdencounters a problem it will return undef but will probably leave youin a different directory. For a measure of extra security, ifeverything appears to have worked, the fastcwd() function will checkthat it leaves you in the same directory that it started in. If it haschanged it will die with the message ``Unstable directory path,current directory changed unexpectedly''. That should never happen.

The cwd() function looks the same as getcwd and fastgetcwd but isimplemented using the most natural and safe form for the currentarchitecture. For most systems it is identical to `pwd` (but withoutthe trailing line terminator).

It is recommended that cwd (or another *cwd() function) is used inall code to ensure portability.

If you ask to override your chdir() built-in function, then your PWDenvironment variable will be kept up to date. (Seethe section on Overriding Builtin Functions in the perlsub manpage.) Note that it will only bekept up to date if all packages which use chdir import it from Cwd.

This document was created byman2html,using the manual pages.