Sub::Identify - Retrieve names of code references
use Sub::Identify ':all'; my $subname = sub_name( $some_coderef ); my $p = stash_name( $some_coderef ); my $fully_qualified_name = sub_fullname( $some_coderef ); defined $subname and say "this coderef points to sub $subname in package $p"; my ($file, $line) = get_code_location( $some_coderef ); is_sub_constant( $some_coderef ) and say "this coderef points to a constant subroutine";
Sub::Identify allows you to retrieve the real name of code references.
It provides four functions :
sub_name returns the name of the subroutine (or
__ANON__ if it's an anonymous code reference),
stash_name returns its package, and
sub_fullname returns the concatenation of the two.
The fourth function,
get_code_info, returns a list of two elements, the package and the subroutine name (in case of you want both and are worried by the speed.)
In case of subroutine aliasing, those functions always return the original name.
Sub::Identify tries to load an XS implementation of the
get_code_info function, for speed; if that fails, or if the environment variable PERL_SUB_IDENTIFY_PP is defined to a true value, it will fall back to a pure perl implementation, that uses perl's introspection mechanism, provided by the
A git repository for the sources is at https://github.com/rgs/Sub-Identify.
(c) Rafael Garcia-Suarez (rgs at consttype dot org) 2005, 2008, 2012, 2014
This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.