NAME

       B::Hooks::OP::PPAddr - Hook into opcode execution

VERSION

       version 0.06

SYNOPSIS

           #include "hook_op_check.h"
           #include "hook_op_ppaddr.h"

           STATIC OP *
           execute_entereval (pTHX_ OP *op, void *user_data) {
               ...
           }

           STATIC OP *
           check_entereval (pTHX_ OP *op, void *user_data) {
               hook_op_ppaddr (op, execute_entereval, NULL);
           }

           hook_op_check (OP_ENTEREVAL, check_entereval, NULL);

DESCRIPTION

       This module provides a C API for XS modules to hook into the execution of perl opcodes.

       ExtUtils::Depends is used to export all functions for other XS modules to use. Include the
       following in your Makefile.PL:

           my $pkg = ExtUtils::Depends->new('Your::XSModule', 'B::Hooks::OP::PPAddr');
           WriteMakefile(
               ... # your normal makefile flags
               $pkg->get_makefile_vars,
           );

       Your XS module can now include "hook_op_ppaddr.h".

TYPES

   OP
           typedef OP *(*hook_op_ppaddr_cb_t) (pTHX_ OP *, void *user_data)

       Type that callbacks need to implement.

FUNCTIONS

   hook_op_ppaddr
           void hook_op_ppaddr (OP *op, hook_op_ppaddr_cb_t cb, void *user_data)

       Replace the function to execute "op" with the callback "cb". "user_data" will be passed to
       the callback as the last argument.

   hook_op_ppaddr_around
           void hook_op_ppaddr_around (OP *op, hook_op_ppaddr_cb_t before, hook_op_ppaddr_cb_t after, void *user_data)

       Register the callbacks "before" and "after" to be called before and after the execution of
       "op". "user_data" will be passed to the callback as the last argument.

SEE ALSO

       •   B::Hooks::OP::Check

SUPPORT

       Bugs may be submitted through the RT bug tracker
       <https://rt.cpan.org/Public/Dist/Display.html?Name=B-Hooks-OP-PPAddr> (or
       bug-B-Hooks-OP-PPAddr@rt.cpan.org <mailto:bug-B-Hooks-OP-PPAddr@rt.cpan.org>).

AUTHOR

       Florian Ragwitz <rafl@debian.org>

CONTRIBUTORS

       •   Karen Etheridge <ether@cpan.org>

       •   Alexandr Ciornii <alexchorny@gmail.com>

       •   Stephan Loyd <stephanloyd9@gmail.com>

COPYRIGHT AND LICENCE

       This software is copyright (c) 2008 by Florian Ragwitz.

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