[14489] | 1 | package B::Terse;
|
---|
| 2 |
|
---|
| 3 | our $VERSION = '1.03_01';
|
---|
| 4 |
|
---|
| 5 | use strict;
|
---|
| 6 | use B qw(class);
|
---|
| 7 | use B::Asmdata qw(@specialsv_name);
|
---|
| 8 | use B::Concise qw(concise_subref set_style_standard);
|
---|
| 9 | use Carp;
|
---|
| 10 |
|
---|
| 11 | sub terse {
|
---|
| 12 | my ($order, $subref) = @_;
|
---|
| 13 | set_style_standard("terse");
|
---|
| 14 | if ($order eq "exec") {
|
---|
| 15 | concise_subref('exec', $subref);
|
---|
| 16 | } else {
|
---|
| 17 | concise_subref('basic', $subref);
|
---|
| 18 | }
|
---|
| 19 | }
|
---|
| 20 |
|
---|
| 21 | sub compile {
|
---|
| 22 | my @args = @_;
|
---|
| 23 | my $order = @args ? shift(@args) : "";
|
---|
| 24 | $order = "-exec" if $order eq "exec";
|
---|
| 25 | unshift @args, $order if $order ne "";
|
---|
| 26 | B::Concise::compile("-terse", @args);
|
---|
| 27 | }
|
---|
| 28 |
|
---|
| 29 | sub indent {
|
---|
| 30 | my ($level) = @_ ? shift : 0;
|
---|
| 31 | return " " x $level;
|
---|
| 32 | }
|
---|
| 33 |
|
---|
| 34 | # Don't use this, at least on OPs in subroutines: it has no way of
|
---|
| 35 | # getting to the pad, and will give wrong answers or crash.
|
---|
| 36 | sub B::OP::terse {
|
---|
| 37 | carp "B::OP::terse is deprecated; use B::Concise instead";
|
---|
| 38 | B::Concise::b_terse(@_);
|
---|
| 39 | }
|
---|
| 40 |
|
---|
| 41 | sub B::SV::terse {
|
---|
| 42 | my($sv, $level) = (@_, 0);
|
---|
| 43 | my %info;
|
---|
| 44 | B::Concise::concise_sv($sv, \%info);
|
---|
| 45 | my $s = indent($level)
|
---|
| 46 | . B::Concise::fmt_line(\%info, $sv,
|
---|
| 47 | "#svclass~(?((#svaddr))?)~#svval", 0);
|
---|
| 48 | chomp $s;
|
---|
| 49 | print "$s\n" unless defined wantarray;
|
---|
| 50 | $s;
|
---|
| 51 | }
|
---|
| 52 |
|
---|
| 53 | sub B::NULL::terse {
|
---|
| 54 | my ($sv, $level) = (@_, 0);
|
---|
| 55 | my $s = indent($level) . sprintf "%s (0x%lx)", class($sv), $$sv;
|
---|
| 56 | print "$s\n" unless defined wantarray;
|
---|
| 57 | $s;
|
---|
| 58 | }
|
---|
| 59 |
|
---|
| 60 | sub B::SPECIAL::terse {
|
---|
| 61 | my ($sv, $level) = (@_, 0);
|
---|
| 62 | my $s = indent($level)
|
---|
| 63 | . sprintf( "%s #%d %s", class($sv), $$sv, $specialsv_name[$$sv]);
|
---|
| 64 | print "$s\n" unless defined wantarray;
|
---|
| 65 | $s;
|
---|
| 66 | }
|
---|
| 67 |
|
---|
| 68 | 1;
|
---|
| 69 |
|
---|
| 70 | __END__
|
---|
| 71 |
|
---|
| 72 | =head1 NAME
|
---|
| 73 |
|
---|
| 74 | B::Terse - Walk Perl syntax tree, printing terse info about ops
|
---|
| 75 |
|
---|
| 76 | =head1 SYNOPSIS
|
---|
| 77 |
|
---|
| 78 | perl -MO=Terse[,OPTIONS] foo.pl
|
---|
| 79 |
|
---|
| 80 | =head1 DESCRIPTION
|
---|
| 81 |
|
---|
| 82 | This version of B::Terse is really just a wrapper that calls B::Concise
|
---|
| 83 | with the B<-terse> option. It is provided for compatibility with old scripts
|
---|
| 84 | (and habits) but using B::Concise directly is now recommended instead.
|
---|
| 85 |
|
---|
| 86 | For compatibility with the old B::Terse, this module also adds a
|
---|
| 87 | method named C<terse> to B::OP and B::SV objects. The B::SV method is
|
---|
| 88 | largely compatible with the old one, though authors of new software
|
---|
| 89 | might be advised to choose a more user-friendly output format. The
|
---|
| 90 | B::OP C<terse> method, however, doesn't work well. Since B::Terse was
|
---|
| 91 | first written, much more information in OPs has migrated to the
|
---|
| 92 | scratchpad datastructure, but the C<terse> interface doesn't have any
|
---|
| 93 | way of getting to the correct pad. As a kludge, the new version will
|
---|
| 94 | always use the pad for the main program, but for OPs in subroutines
|
---|
| 95 | this will give the wrong answer or crash.
|
---|
| 96 |
|
---|
| 97 | =head1 AUTHOR
|
---|
| 98 |
|
---|
| 99 | The original version of B::Terse was written by Malcolm Beattie,
|
---|
| 100 | E<lt>[email protected]<gt>. This wrapper was written by Stephen
|
---|
| 101 | McCamant, E<lt>[email protected]<gt>.
|
---|
| 102 |
|
---|
| 103 | =cut
|
---|