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

Sub::Inspector - get infomation (prototype, attributes, name, etc) from a subroutine reference

SYNOPSIS

use Sub::Inspector;

# get file, line, name

use File::Spec;
my $code = File::Spec->can('canonpath');
my $inspector = Sub::Inspector->new($code);

print $inspector->file; #=> '/Users/Cside/perl5/ ... /File/Spec/Unix.pm'
print $inspector->line; #=> 71
print $inspector->name; #=> 'canonpath'

# get prototype

use Try::Tiny qw(try);
my $inspector2 = Sub::Inspector->new(\&try);

print $inspector2->proto; #=> '&;@'

# get attributes

use AnyEvent::Handle;
my $code3 = AnyEvent::Handle->can('rbuf');
my $inspector3 = Sub::Inspector->new($code3);

print $inspector3->attrs; #=> ('lvalue')

DESCRIPTION

This module enable to get metadata (prototype, attributes, method name, etc) from a coderef. We can get them by the buit-in module, B.pm. However, it is a bit difficult to memorize how to use it.

Functions

$inspector->file
$inspector->line
$inspector->name
$inspector->proto

alias: prototype

$inspector->attrs

alias: attributes

SEE ALSO

B
B::Deparser

AUTHOR

Hiroki Honda (Cside) <cside.story [at] gmail.com>

LICENSE AND COPYRIGHT

Copyright (c) Hiroki Honda.

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