GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AUTODIE::SCOPE::GUARDSTACK (3)

.ds Aq ’

NAME

autodie::Scope::GuardStack - Hook stack for managing scopes via %^H

CONTENTS

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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 AUTODIE::SCOPE::GUARDSTACK (3) 2015-07-09

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.