---
name: "B::Hooks::OP::PPAddr"
section: "3pm"
platform: "linux"
package: "libb-hooks-op-ppaddr-perl"
version: "0.06-3+b3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/B::Hooks::OP::PPAddr"
---

# B::Hooks::OP::PPAddr(3pm)

Hook into opcode execution

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