NAME

Perl::AtEndOfScope - run some code when a variable goes out of scope

SYNOPSIS

            

              
              
use Perl::AtEndOfScope;
use Cwd;
{
  my $restorecwd=Perl::AtEndOfScope->new( sub{chdir $_[0]}, getcwd );
  chdir '/path/to/some/directory';
  ...
}
# now we are back to the old cwd
# or better using the undocumented "chdir FILEHANDLE"
use Perl::AtEndOfScope;
{
  my $restorecwd=Perl::AtEndOfScope->new( sub{chdir $_[0]},
                                          do {opendir my $d, '.'; $d} );
  chdir '/path/to/some/directory';
  ...
}
# now we are back to the old cwd
            
          

DESCRIPTION

It's often necessary to do some cleanup at the end of a scope. This module creates a Perl object and executes arbitrary code when the object goes out of scope.

METHODS

Perl::AtEndOfScope->new( $sub, @args )

the constructor. The code reference passed in $sub is called with @args as parameter list when the object is destroyed.

While $sub is executed the following variables are preserved:

            

              
              
$@, $a, $b, $_, $., $!, $^E, $?
            
          

This list can grow in future versions.

$sub is executed within an eval block. You can check

            

              
              
$Perl::AtEndOfFile::EXC
            
          

to see if an exception has been thrown by it. $Perl::AtEndOfScope::EXC is not stringified.

If multiple Perl::AtEndOfScope objects are destroyed at the same time only the last exception thrown by one of them is saved.

DESTROY( $self )

the destructor.

EXPORT

Not an Exporter.

AUTHOR

Torsten Foertsch, <torsten.foertsch@gmx.net>

COPYRIGHT AND LICENSE

Copyright (C) 2005-2008 by Torsten Foertsch

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