The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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

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>

  • 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.