on_scope_end

    on_scope_end { ... };

    on_scope_end $code;

Registers $code to be executed after the surrounding scope has been compiled.

This is exported by default. See Sub::Exporter on how to customize it.

Pure-perl mode caveat

While Variable::Magic has access to some very dark sorcery to make it possible to throw an exception from within a callback, the pure-perl implementation does not have access to these hacks. Therefore, what would have been a compile-time exception is instead converted to a warning, and your execution will continue as if the exception never happened.

To explicitly request an XS (or PP) implementation one has two choices. Either to import from the desired implementation explicitly:

 use B::Hooks::EndOfScope::XS
   or
 use B::Hooks::EndOfScope::PP

or by setting $ENV{B_HOOKS_ENDOFSCOPE_IMPLEMENTATION} to either "XS" or "PP".

Perl 5.8.0 ~ 5.8.3

In order to stabilize this workaround use of Variable::Magic is disabled on perls prior to version 5.8.4. On such systems loading/requesting B::Hooks::EndOfScope::XS explicitly will result in a compile-time exception.

Perl versions 5.6.x

For further details on the unavailable behavior please refer to the test file t/02-localise.t included with the distribution.