Man pages sections > man3 > Cwd::Guard

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

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.
2016-05-22 perl v5.22.2