GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SUB::IDENTIFY (3)

.ds Aq ’

NAME

Sub::Identify - Retrieve names of code references

CONTENTS

SYNOPSIS



    use Sub::Identify :all;
    my $subname = sub_name( $some_coderef );
    my $packagename = stash_name( $some_coderef );
    # or, to get all at once...
    my $fully_qualified_name = sub_fullname( $some_coderef );
    defined $subname
        and say "this coderef points to sub $subname in package $packagename";
    my ($file, $line) = get_code_location( $some_coderef );
    $file
        and say "this coderef is defined at line $line in file $file";
    is_sub_constant( $some_coderef )
        and say "this coderef points to a constant subroutine";



DESCRIPTION

Sub::Identify allows you to retrieve the real name of code references.

It provides six functions, all of them taking a code reference.

sub_name returns the name of the code reference passed as an argument (or __ANON__ if it’s an anonymous code reference), stash_name returns its package, and sub_fullname returns the concatenation of the two.

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.

get_code_location returns a two-element list containing the file name and the line number where the subroutine has been defined.

is_sub_constant returns a boolean value indicating whether the subroutine is a constant or not.

    Pure-Perl version

By default Sub::Identify tries to load an XS implementation of the get_code_info, get_code_location and (on perl versions 5.16.0 and later) is_sub_constant functions, 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 B module.

SEE ALSO

Sub::Util, part of the module distribution Scalar::List::Utils since version 1.40. Since this will be a core module starting with perl 5.22.0, it is encouraged to migrate to Sub::Util when possible.

Sub::Name

SOURCE

A git repository for the sources is at <https://github.com/rgs/Sub-Identify>.

LICENSE

(c) Rafael Garcia-Suarez (rgs at consttype dot org) 2005, 2008, 2012, 2014, 2015

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 SUB::IDENTIFY (3) 2015-09-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.