<h2>Editing File: /usr/share/perl5/dumpvar.pl</h2><form method='post'><textarea name='content' class='file-edit'>require 5.014;			# For more reliable $@ after eval
package dumpvar;

# Needed for PrettyPrinter only:

# require 5.001;  # Well, it coredumps anyway undef DB in 5.000 (not now)

# translate control chars to ^X - Randal Schwartz
# Modifications to print types by Peter Gordon v1.0

# Ilya Zakharevich -- patches after 5.001 (and some before ;-)

# Won't dump symbol tables and contents of debugged files by default

$winsize = 80 unless defined $winsize;

sub ASCII { return ord('A') == 65; }


# Defaults

# $globPrint = 1;
$printUndef = 1 unless defined $printUndef;
$tick = &quot;auto&quot; unless defined $tick;
$unctrl = 'quote' unless defined $unctrl;
$subdump = 1;
$dumpReused = 0 unless defined $dumpReused;
$bareStringify = 1 unless defined $bareStringify;

my $APC = chr utf8::unicode_to_native(0x9F);
my $backslash_c_question = (ASCII) ? '\177' : $APC;

sub main::dumpValue {
  local %address;
  local $^W=0;
  (print &quot;undef\n&quot;), return unless defined $_[0];
  (print &amp;stringify($_[0]), &quot;\n&quot;), return unless ref $_[0];
  push @_, -1 if @_ == 1;
  dumpvar::unwrap($_[0], 0, $_[1]);
}

# This one is good for variable names:

sub unctrl {
    for (my($dummy) = shift) {
	local($v) ; 

	return \$_ if ref \$_ eq &quot;GLOB&quot;;
        s/([\000-\037])/ '^' . chr(utf8::unicode_to_native(ord($1)^64))/eg;
        s/ $backslash_c_question /^?/xg;
	return $_;
    }
}

sub uniescape {
    join(&quot;&quot;,
	 map { $_ &gt; 255 ? sprintf(&quot;\\x{%04X}&quot;, $_) : chr($_) }
	     unpack(&quot;W*&quot;, $_[0]));
}

sub stringify {
  my $string;
  if (eval { $string = _stringify(@_); 1 }) {
    return $string;
  }

  return &quot;&lt;&lt; value could not be dumped: $@ &gt;&gt;&quot;;
}

sub _stringify {
    (my $__, local $noticks) = @_;
    for ($__) {
	local($v) ; 
	my $tick = $tick;

	return 'undef' unless defined $_ or not $printUndef;
	return $_ . &quot;&quot; if ref \$_ eq 'GLOB';
	$_ = &amp;{'overload::StrVal'}($_) 
	  if $bareStringify and ref $_ 
	    and %overload:: and defined &amp;{'overload::StrVal'};
	
	if ($tick eq 'auto') {
            if (/[^[:^cntrl:]\n]/u) {   # All controls but \n get '&quot;'
                $tick = '&quot;';
            } else {
                $tick = &quot;'&quot;;
            }
	}
	if ($tick eq &quot;'&quot;) {
	  s/([\'\\])/\\$1/g;
	} elsif ($unctrl eq 'unctrl') {
	  s/([\&quot;\\])/\\$1/g ;
          $_ = &amp;unctrl($_);
	  # uniescape?
	  s/([[:^ascii:]])/'\\0x'.sprintf('%2X',ord($1))/eg
	    if $quoteHighBit;
	} elsif ($unctrl eq 'quote') {
	  s/([\&quot;\\\$\@])/\\$1/g if $tick eq '&quot;';
	  s/\e/\\e/g;
          s/([\000-\037$backslash_c_question])/'\\c'._escaped_ord($1)/eg;
	}
	$_ = uniescape($_);
	s/([[:^ascii:]])/'\\'.sprintf('%3o',ord($1))/eg if $quoteHighBit;
	return ($noticks || /^\d+(\.\d*)?\Z/) 
	  ? $_ 
	  : $tick . $_ . $tick;
    }
}

# Ensure a resulting \ is escaped to be \\
sub _escaped_ord {
    my $chr = shift;
    if ($chr eq $backslash_c_question) {
        $chr = '?';
    }
    else {
        $chr = chr(utf8::unicode_to_native(ord($chr)^64));
        $chr =~ s{\\}{\\\\}g;
    }
    return $chr;
}

sub ShortArray {
  my $tArrayDepth = $#{$_[0]} ; 
  $tArrayDepth = $#{$_[0]} &lt; $arrayDepth-1 ? $#{$_[0]} : $arrayDepth-1 
    unless  $arrayDepth eq '' ; 
  my $shortmore = &quot;&quot;;
  $shortmore = &quot; ...&quot; if $tArrayDepth &lt; $#{$_[0]} ;
  if (!grep(ref $_, @{$_[0]})) {
    $short = &quot;0..$#{$_[0]}  '&quot; . 
      join(&quot;' '&quot;, @{$_[0]}[0..$tArrayDepth]) . &quot;'$shortmore&quot;;
    return $short if length $short &lt;= $compactDump;
  }
  undef;
}

sub DumpElem {
  my $short = &amp;stringify($_[0], ref $_[0]);
  if ($veryCompact &amp;&amp; ref $_[0]
      &amp;&amp; (ref $_[0] eq 'ARRAY' and !grep(ref $_, @{$_[0]}) )) {
    my $end = &quot;0..$#{$v}  '&quot; . 
      join(&quot;' '&quot;, @{$_[0]}[0..$tArrayDepth]) . &quot;'$shortmore&quot;;
  } elsif ($veryCompact &amp;&amp; ref $_[0]
      &amp;&amp; (ref $_[0] eq 'HASH') and !grep(ref $_, values %{$_[0]})) {
    my $end = 1;
	  $short = $sp . &quot;0..$#{$v}  '&quot; . 
	    join(&quot;' '&quot;, @{$v}[0..$tArrayDepth]) . &quot;'$shortmore&quot;;
  } else {
    print &quot;$short\n&quot;;
    unwrap($_[0],$_[1],$_[2]) if ref $_[0];
  }
}

sub unwrap {
    return if $DB::signal;
    local($v) = shift ; 
    local($s) = shift ; # extra no of spaces
    local($m) = shift ; # maximum recursion depth
    return if $m == 0;
    local(%v,@v,$sp,$value,$key,@sortKeys,$more,$shortmore,$short) ;
    local($tHashDepth,$tArrayDepth) ;

    $sp = &quot; &quot; x $s ;
    $s += 3 ; 

    eval {
    # Check for reused addresses
    if (ref $v) { 
      my $val = $v;
      $val = &amp;{'overload::StrVal'}($v) 
	if %overload:: and defined &amp;{'overload::StrVal'};
      # Match type and address.                      
      # Unblessed references will look like TYPE(0x...)
      # Blessed references will look like Class=TYPE(0x...)
      $val =~ s/^.*=//; # suppress the Class part, just keep TYPE(0x...)
      ($item_type, $address) = 
        $val =~ /([^\(]+)        # Keep stuff that's     
                                 # not an open paren
                 \(              # Skip open paren
                 (0x[0-9a-f]+)   # Save the address
                 \)              # Skip close paren
                 $/x;            # Should be at end now

      if (!$dumpReused &amp;&amp; defined $address) { 
	$address{$address}++ ;
	if ( $address{$address} &gt; 1 ) { 
	  print &quot;${sp}-&gt; REUSED_ADDRESS\n&quot; ; 
	  return ; 
	} 
      }
    } elsif (ref \$v eq 'GLOB') {
      # This is a raw glob. Special handling for that.
      $address = &quot;$v&quot; . &quot;&quot;;	# To avoid a bug with globs
      $address{$address}++ ;
      if ( $address{$address} &gt; 1 ) { 
	print &quot;${sp}*DUMPED_GLOB*\n&quot; ; 
	return ; 
      } 
    }

    if (ref $v eq 'Regexp') {
      # Reformat the regexp to look the standard way.
      my $re = &quot;$v&quot;;
      $re =~ s,/,\\/,g;
      print &quot;$sp-&gt; qr/$re/\n&quot;;
      return;
    }

    if ( $item_type eq 'HASH' ) { 
        # Hash ref or hash-based object.
	my @sortKeys = sort keys(%$v) ;
	undef $more ; 
	$tHashDepth = $#sortKeys ; 
	$tHashDepth = $#sortKeys &lt; $hashDepth-1 ? $#sortKeys : $hashDepth-1
	  unless $hashDepth eq '' ; 
	$more = &quot;....\n&quot; if $tHashDepth &lt; $#sortKeys ; 
	$shortmore = &quot;&quot;;
	$shortmore = &quot;, ...&quot; if $tHashDepth &lt; $#sortKeys ; 
	$#sortKeys = $tHashDepth ; 
	if ($compactDump &amp;&amp; !grep(ref $_, values %{$v})) {
	  #$short = $sp . 
	  #  (join ', ', 
# Next row core dumps during require from DB on 5.000, even with map {&quot;_&quot;}
	  #   map {&amp;stringify($_) . &quot; =&gt; &quot; . &amp;stringify($v-&gt;{$_})} 
	  #   @sortKeys) . &quot;'$shortmore&quot;;
	  $short = $sp;
	  my @keys;
	  for (@sortKeys) {
	    push @keys, &amp;stringify($_) . &quot; =&gt; &quot; . &amp;stringify($v-&gt;{$_});
	  }
	  $short .= join ', ', @keys;
	  $short .= $shortmore;
	  (print &quot;$short\n&quot;), return if length $short &lt;= $compactDump;
	}
	for $key (@sortKeys) {
	    return if $DB::signal;
	    $value = $ {$v}{$key} ;
	    print &quot;$sp&quot;, &amp;stringify($key), &quot; =&gt; &quot;;
	    DumpElem $value, $s, $m-1;
	}
	print &quot;$sp  empty hash\n&quot; unless @sortKeys;
	print &quot;$sp$more&quot; if defined $more ;
    } elsif ( $item_type eq 'ARRAY' ) { 
        # Array ref or array-based object. Also: undef.
        # See how big the array is.
	$tArrayDepth = $#{$v} ; 
	undef $more ; 
        # Bigger than the max?
	$tArrayDepth = $#{$v} &lt; $arrayDepth-1 ? $#{$v} : $arrayDepth-1 
	  if defined $arrayDepth &amp;&amp; $arrayDepth ne '';
        # Yep. Don't show it all.
	$more = &quot;....\n&quot; if $tArrayDepth &lt; $#{$v} ; 
	$shortmore = &quot;&quot;;
	$shortmore = &quot; ...&quot; if $tArrayDepth &lt; $#{$v} ;

	if ($compactDump &amp;&amp; !grep(ref $_, @{$v})) {
	  if ($#$v &gt;= 0) {
	    $short = $sp . &quot;0..$#{$v}  &quot; . 
	      join(&quot; &quot;, 
		   map {exists $v-&gt;[$_] ? stringify $v-&gt;[$_] : &quot;empty&quot;} (0..$tArrayDepth)
		  ) . &quot;$shortmore&quot;;
	  } else {
	    $short = $sp . &quot;empty array&quot;;
	  }
	  (print &quot;$short\n&quot;), return if length $short &lt;= $compactDump;
	}
	#if ($compactDump &amp;&amp; $short = ShortArray($v)) {
	#  print &quot;$short\n&quot;;
	#  return;
	#}
	for $num (0 .. $tArrayDepth) {
	    return if $DB::signal;
	    print &quot;$sp$num  &quot;;
	    if (exists $v-&gt;[$num]) {
                if (defined $v-&gt;[$num]) {
	          DumpElem $v-&gt;[$num], $s, $m-1;
                } 
                else {
                  print &quot;undef\n&quot;;
                }
	    } else {
	    	print &quot;empty slot\n&quot;;
	    }
	}
	print &quot;$sp  empty array\n&quot; unless @$v;
	print &quot;$sp$more&quot; if defined $more ;  
    } elsif ( $item_type eq 'SCALAR' ) { 
            unless (defined $$v) {
              print &quot;$sp-&gt; undef\n&quot;;
              return;
            }
	    print &quot;$sp-&gt; &quot;;
	    DumpElem $$v, $s, $m-1;
    } elsif ( $item_type eq 'REF' ) { 
	    print &quot;$sp-&gt; $$v\n&quot;;
            return unless defined $$v;
	    unwrap($$v, $s+3, $m-1);
    } elsif ( $item_type eq 'CODE' ) { 
            # Code object or reference.
	    print &quot;$sp-&gt; &quot;;
	    dumpsub (0, $v);
    } elsif ( $item_type eq 'GLOB' ) {
      # Glob object or reference.
      print &quot;$sp-&gt; &quot;,&amp;stringify($$v,1),&quot;\n&quot;;
      if ($globPrint) {
	$s += 3;
       dumpglob($s, &quot;{$$v}&quot;, $$v, 1, $m-1);
      } elsif (defined ($fileno = eval {fileno($v)})) {
	print( (' ' x ($s+3)) .  &quot;FileHandle({$$v}) =&gt; fileno($fileno)\n&quot; );
      }
    } elsif (ref \$v eq 'GLOB') {
      # Raw glob (again?)
      if ($globPrint) {
       dumpglob($s, &quot;{$v}&quot;, $v, 1, $m-1) if $globPrint;
      } elsif (defined ($fileno = eval {fileno(\$v)})) {
	print( (' ' x $s) .  &quot;FileHandle({$v}) =&gt; fileno($fileno)\n&quot; );
      }
    }
    };
    if ($@) {
      print( (' ' x $s) .  &quot;&lt;&lt; value could not be dumped: $@ &gt;&gt;\n&quot;);
    }

    return;
}

sub matchlex {
  (my $var = $_[0]) =~ s/.//;
  $var eq $_[1] or 
    ($_[1] =~ /^([!~])(.)([\x00-\xff]*)/) and 
      ($1 eq '!') ^ (eval { $var =~ /$2$3/ });
}

sub matchvar {
  $_[0] eq $_[1] or 
    ($_[1] =~ /^([!~])(.)([\x00-\xff]*)/) and 
      ($1 eq '!') ^ (eval {($_[2] . &quot;::&quot; . $_[0]) =~ /$2$3/});
}

sub compactDump {
  $compactDump = shift if @_;
  $compactDump = 6*80-1 if $compactDump and $compactDump &lt; 2;
  $compactDump;
}

sub veryCompact {
  $veryCompact = shift if @_;
  compactDump(1) if !$compactDump and $veryCompact;
  $veryCompact;
}

sub unctrlSet {
  if (@_) {
    my $in = shift;
    if ($in eq 'unctrl' or $in eq 'quote') {
      $unctrl = $in;
    } else {
      print &quot;Unknown value for 'unctrl'.\n&quot;;
    }
  }
  $unctrl;
}

sub quote {
  if (@_ and $_[0] eq '&quot;') {
    $tick = '&quot;';
    $unctrl = 'quote';
  } elsif (@_ and $_[0] eq 'auto') {
    $tick = 'auto';
    $unctrl = 'quote';
  } elsif (@_) {		# Need to set
    $tick = &quot;'&quot;;
    $unctrl = 'unctrl';
  }
  $tick;
}

sub dumpglob {
    return if $DB::signal;
    my ($off,$key, $val, $all, $m) = @_;
    local(*entry) = $val;
    my $fileno;
    if (($key !~ /^_&lt;/ or $dumpDBFiles) and defined $entry) {
      print( (' ' x $off) . &quot;\$&quot;, &amp;unctrl($key), &quot; = &quot; );
      DumpElem $entry, 3+$off, $m;
    }
    if (($key !~ /^_&lt;/ or $dumpDBFiles) and @entry) {
      print( (' ' x $off) . &quot;\@$key = (\n&quot; );
      unwrap(\@entry,3+$off,$m) ;
      print( (' ' x $off) .  &quot;)\n&quot; );
    }
    if ($key ne &quot;main::&quot; &amp;&amp; $key ne &quot;DB::&quot; &amp;&amp; %entry
	&amp;&amp; ($dumpPackages or $key !~ /::$/)
	&amp;&amp; ($key !~ /^_&lt;/ or $dumpDBFiles)
	&amp;&amp; !($package eq &quot;dumpvar&quot; and $key eq &quot;stab&quot;)) {
      print( (' ' x $off) . &quot;\%$key = (\n&quot; );
      unwrap(\%entry,3+$off,$m) ;
      print( (' ' x $off) .  &quot;)\n&quot; );
    }
    if (defined ($fileno = eval{fileno(*entry)})) {
      print( (' ' x $off) .  &quot;FileHandle($key) =&gt; fileno($fileno)\n&quot; );
    }
    if ($all) {
      if (defined &amp;entry) {
	dumpsub($off, $key);
      }
    }
}

sub dumplex {
  return if $DB::signal;
  my ($key, $val, $m, @vars) = @_;
  return if @vars &amp;&amp; !grep( matchlex($key, $_), @vars );
  local %address;
  my $off = 0;  # It reads better this way
  my $fileno;
  if (UNIVERSAL::isa($val,'ARRAY')) {
    print( (' ' x $off) . &quot;$key = (\n&quot; );
    unwrap($val,3+$off,$m) ;
    print( (' ' x $off) .  &quot;)\n&quot; );
  }
  elsif (UNIVERSAL::isa($val,'HASH')) {
    print( (' ' x $off) . &quot;$key = (\n&quot; );
    unwrap($val,3+$off,$m) ;
    print( (' ' x $off) .  &quot;)\n&quot; );
  }
  elsif (UNIVERSAL::isa($val,'IO')) {
    print( (' ' x $off) .  &quot;FileHandle($key) =&gt; fileno($fileno)\n&quot; );
  }
  #  No lexical subroutines yet...
  #  elsif (UNIVERSAL::isa($val,'CODE')) {
  #    dumpsub($off, $$val);
  #  }
  else {
    print( (' ' x $off) . &amp;unctrl($key), &quot; = &quot; );
    DumpElem $$val, 3+$off, $m;
  }
}

sub CvGV_name_or_bust {
  my $in = shift;
  return if $skipCvGV;		# Backdoor to avoid problems if XS broken...
  $in = \&amp;$in;			# Hard reference...
  eval {require Devel::Peek; 1} or return;
  my $gv = Devel::Peek::CvGV($in) or return;
  *$gv{PACKAGE} . '::' . *$gv{NAME};
}

sub dumpsub {
    my ($off,$sub) = @_;
    my $ini = $sub;
    my $s;
    $sub = $1 if $sub =~ /^\{\*(.*)\}$/;
    my $subref = defined $1 ? \&amp;$sub : \&amp;$ini;
    my $place = $DB::sub{$sub} || (($s = $subs{&quot;$subref&quot;}) &amp;&amp; $DB::sub{$s})
      || (($s = CvGV_name_or_bust($subref)) &amp;&amp; $DB::sub{$s})
      || ($subdump &amp;&amp; ($s = findsubs(&quot;$subref&quot;)) &amp;&amp; $DB::sub{$s});
    $place = '???' unless defined $place;
    $s = $sub unless defined $s;
    print( (' ' x $off) .  &quot;&amp;$s in $place\n&quot; );
}

sub findsubs {
  return undef unless %DB::sub;
  my ($addr, $name, $loc);
  while (($name, $loc) = each %DB::sub) {
    $addr = \&amp;$name;
    $subs{&quot;$addr&quot;} = $name;
  }
  $subdump = 0;
  $subs{ shift() };
}

sub main::dumpvar {
    my ($package,$m,@vars) = @_;
    local(%address,$key,$val,$^W);
    $package .= &quot;::&quot; unless $package =~ /::$/;
    *stab = *{&quot;main::&quot;};
    while ($package =~ /(\w+?::)/g){
      *stab = $ {stab}{$1};
    }
    local $TotalStrings = 0;
    local $Strings = 0;
    local $CompleteTotal = 0;
    while (($key,$val) = each(%stab)) {
      return if $DB::signal;
      next if @vars &amp;&amp; !grep( matchvar($key, $_), @vars );
      if ($usageOnly) {
	globUsage(\$val, $key)
	  if ($package ne 'dumpvar' or $key ne 'stab')
	     and ref(\$val) eq 'GLOB';
      } else {
       dumpglob(0,$key, $val, 0, $m);
      }
    }
    if ($usageOnly) {
      print &quot;String space: $TotalStrings bytes in $Strings strings.\n&quot;;
      $CompleteTotal += $TotalStrings;
      print &quot;Grand total = $CompleteTotal bytes (1 level deep) + overhead.\n&quot;;
    }
}

sub scalarUsage {
  my $size = length($_[0]);
  $TotalStrings += $size;
  $Strings++;
  $size;
}

sub arrayUsage {		# array ref, name
  my $size = 0;
  map {$size += scalarUsage($_)} @{$_[0]};
  my $len = @{$_[0]};
  print &quot;\@$_[1] = $len item&quot;, ($len &gt; 1 ? &quot;s&quot; : &quot;&quot;),
    &quot; (data: $size bytes)\n&quot;
      if defined $_[1];
  $CompleteTotal +=  $size;
  $size;
}

sub hashUsage {		# hash ref, name
  my @keys = keys %{$_[0]};
  my @values = values %{$_[0]};
  my $keys = arrayUsage \@keys;
  my $values = arrayUsage \@values;
  my $len = @keys;
  my $total = $keys + $values;
  print &quot;\%$_[1] = $len item&quot;, ($len &gt; 1 ? &quot;s&quot; : &quot;&quot;),
    &quot; (keys: $keys; values: $values; total: $total bytes)\n&quot;
      if defined $_[1];
  $total;
}

sub globUsage {			# glob ref, name
  local *name = *{$_[0]};
  $total = 0;
  $total += scalarUsage $name if defined $name;
  $total += arrayUsage \@name, $_[1] if @name;
  $total += hashUsage \%name, $_[1] if %name and $_[1] ne &quot;main::&quot; 
    and $_[1] ne &quot;DB::&quot;;   #and !($package eq &quot;dumpvar&quot; and $key eq &quot;stab&quot;));
  $total;
}

sub packageUsage {
  my ($package,@vars) = @_;
  $package .= &quot;::&quot; unless $package =~ /::$/;
  local *stab = *{&quot;main::&quot;};
  while ($package =~ /(\w+?::)/g){
    *stab = $ {stab}{$1};
  }
  local $TotalStrings = 0;
  local $CompleteTotal = 0;
  my ($key,$val);
  while (($key,$val) = each(%stab)) {
    next if @vars &amp;&amp; !grep($key eq $_,@vars);
    globUsage \$val, $key unless $package eq 'dumpvar' and $key eq 'stab';
  }
  print &quot;String space: $TotalStrings.\n&quot;;
  $CompleteTotal += $TotalStrings;
  print &quot;\nGrand total = $CompleteTotal bytes\n&quot;;
}

1;

</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Fshare%2Fperl5'>Back to Directory</a>