B::Showlex - perldoc.perl.org

perldoc.perl.org

# Manual:

- Overview
- Tutorials
- FAQs
- History / Changes
- Licence

## Reference:

- Language
- Functions
- Operators
- Special variables
- Pragmas
- Core modules
- Utilities
- Internals
- Platform specific

## Links:

- CPAN
- Perl.org
- Perl.com
- Perl Buzz
- Perl 5 Wiki
- Perl Jobs
- Perl Mongers
- Perl Monks
- Planet Perl
- Use Perl

## Contact:

- Site maintained by
  Jon Allen (JJ)
- Last updated on
  23 December 2007
- See the project page for more details

Show navigation
-- Perl 5.10.0 documentation --
Show toolbar
B::Showlex

- NAME
- SYNOPSIS
- DESCRIPTION
- EXAMPLES
  - OPTIONS
- SEE ALSO
- TODO
- AUTHOR

# NAME

B::Showlex - Show lexical variables used in functions or files

# SYNOPSIS

    	perl -MO=Showlex[,-OPTIONS][,SUBROUTINE] foo.pl

# DESCRIPTION

When a comma-separated list of subroutine names is given as options, Showlex prints the lexical variables used in those subroutines. Otherwise, it prints the file-scope lexicals in the file.

# EXAMPLES

Traditional form:

     $ perl -MO=Showlex -e 'my ($i,$j,$k)=(1,"foo")'
     Pad of lexical names for comppadlist has 4 entries
     0: SPECIAL #1 &PL_sv_undef
     1: PVNV (0x9db0fb0) $i
     2: PVNV (0x9db0f38) $j
     3: PVNV (0x9db0f50) $k
     Pad of lexical values for comppadlist has 5 entries
     0: SPECIAL #1 &PL_sv_undef
     1: NULL (0x9da4234)
     2: NULL (0x9db0f2c)
     3: NULL (0x9db0f44)
     4: NULL (0x9da4264)
     -e syntax OK

New-style form:

     $ perl -MO=Showlex,-newlex -e 'my ($i,$j,$k)=(1,"foo")'
     main Pad has 4 entries
     0: SPECIAL #1 &PL_sv_undef
     1: PVNV (0xa0c4fb8) "$i" = NULL (0xa0b8234)
     2: PVNV (0xa0c4f40) "$j" = NULL (0xa0c4f34)
     3: PVNV (0xa0c4f58) "$k" = NULL (0xa0c4f4c)
     -e syntax OK

New form, no specials, outside O framework:

     $ perl -MB::Showlex -e \
        'my ($i,$j,$k)=(1,"foo"); B::Showlex::compile(-newlex,-nosp)->()'
     main Pad has 4 entries
     1: PVNV (0x998ffb0) "$i" = IV (0x9983234) 1
     2: PVNV (0x998ff68) "$j" = PV (0x998ff5c) "foo"
     3: PVNV (0x998ff80) "$k" = NULL (0x998ff74)

Note that this example shows the values of the lexicals, whereas the other examples did not (as they're compile-time only).

## OPTIONS

The `-newlex` option produces a more readable `name => value` format, and is shown in the second example above.

The `-nosp` option eliminates reporting of SPECIALs, such as `0: SPECIAL #1 &PL_sv_undef` above. Reporting of SPECIALs can sometimes overwhelm your declared lexicals.

# SEE ALSO

`B::Showlex` can also be used outside of the O framework, as in the third example. See `B::Concise` for a fuller explanation of reasons.

# TODO

Some of the reported info, such as hex addresses, is not particularly valuable. Other information would be more useful for the typical programmer, such as line-numbers, pad-slot reuses, etc.. Given this, -newlex isnt a particularly good flag-name.

# AUTHOR

Malcolm Beattie, `mbeattie@sable.ox.ac.uk`

# Search:

## Labels:

Add this page