-
-
22 Jan 2021 17:05:24 UTC
- Distribution: autodie
- Module version: 2.34
- Source (raw)
- Browse (raw)
- Changes
- How to Contribute
- Repository
- Issues
- Testers (1492 / 6 / 9)
- Kwalitee
Bus factor: 5- % Coverage
- License: perl_5
- Perl: v5.8.4
- Activity
24 month- Tools
- Download (91.16KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
NAME
autodie::Scope::GuardStack - Hook stack for managing scopes via %^H
SYNOPSIS
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
new
my $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.
Module Install Instructions
To install autodie, copy and paste the appropriate command in to your terminal.
cpanm autodie
perl -MCPAN -e shell install autodie
For more information on module installation, please visit the detailed CPAN module installation guide.