Cwd::Guard(3pm)       User Contributed Perl Documentation      Cwd::Guard(3pm)


NAME
       Cwd::Guard - Temporary changing working directory (chdir)

SYNOPSIS
         use Cwd::Guard qw/cwd_guard/;
         use Cwd;

         my $dir = getcwd;
         MYBLOCK: {
             my $guard = cwd_guard('/tmp/xxxxx') or die "failed chdir: $Cwd::Guard::Error";
             # chdir to /tmp/xxxxx
         }
         # back to $dir

DESCRIPTION
       CORE::chdir Cwd:: Guard can change the current directory (chdir) using
       a limited scope.

FUNCTIONS
       cwd_guard($dir);
           chdir to $dir and returns Cwd::Guard object. return to current
           working directory, if this object destroyed.  if failed to chdir,
           cwd_guard return undefined value. You can get error messages with
           $Gwd::Guard::Error.

AUTHOR
       Masahiro Nagano <kazeburo {at} gmail.com>

SEE ALSO
       File::chdir, File::pushd

LICENSE
       Copyright (C) Masahiro Nagano

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

perl v5.38.0                      2023-07-25                   Cwd::Guard(3pm)