NAME
B::Hooks::OP::PPAddr - Hook into opcode execution
VERSION
version 0.05
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
SUPPORT
Bugs may be submitted through the RT bug tracker (or 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>
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.