table of contents
other versions
- stretch 5.24.1-3+deb9u5
- testing 5.28.1-6
- unstable 5.28.1-6
- experimental 5.30.0-3
other sections
autodie::Scope::GuardStack(3perl) | Perl Programmers Reference Guide | autodie::Scope::GuardStack(3perl) |
NAME¶
autodie::Scope::GuardStack - Hook stack for managing scopes via %^HSYNOPSIS¶
use autodie::Scope::GuardStack; my $stack = autodie::Scope::GuardStack->new $^H{'my-key'} = $stack; $stack->push_hook(sub {});
DESCRIPTION¶
This class is a stack of hooks to be called in the right order as scopes go away. The stack is only useful when inserted into "%^H" and will pop hooks as their "scope" is popped. This is useful for uninstalling or reinstalling subs in a namespace as a pragma goes out of scope.Due to how "%^H" works, this class is only useful during the compilation phase of a perl module and relies on the internals of how perl handles references in "%^H". This module is not a part of autodie's public API.
Methods¶
newmy $stack = autodie::Scope::GuardStack->new;
Creates a new "autodie::Scope::GuardStack". The stack is initially empty and must be inserted into "%^H" by the creator.
push_hook
$stack->push_hook(sub {});
Add a sub to the stack. The sub will be called once the current compile-time "scope" is left. Multiple hooks can be added per scope
AUTHOR¶
Copyright 2013, Niels Thykier <niels@thykier.net>LICENSE¶
This module is free software. You may distribute it under the same terms as Perl itself.2018-11-29 | perl v5.24.1 |