ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Devel-FindRef/FindRef.pm
(Generate patch)

Comparing Devel-FindRef/FindRef.pm (file contents):
Revision 1.13 by root, Fri Jul 11 22:18:10 2008 UTC vs.
Revision 1.15 by root, Sat Jul 19 01:38:57 2008 UTC

1package Devel::FindRef; 1package Devel::FindRef;
2 2
3no warnings; # I hate warning nazis
3use strict; 4use strict;
4 5
5use XSLoader; 6use XSLoader;
6use Scalar::Util; 7use Scalar::Util;
7 8
8BEGIN { 9BEGIN {
9 our $VERSION = '1.3'; 10 our $VERSION = '1.31';
10 XSLoader::load __PACKAGE__, $VERSION; 11 XSLoader::load __PACKAGE__, $VERSION;
11} 12}
12 13
13=head1 NAME 14=head1 NAME
14 15
… …
119 my (@about) = find $$refref; 120 my (@about) = find $$refref;
120 if (@about) { 121 if (@about) {
121 for my $about (@about) { 122 for my $about (@about) {
122 $buf .= "$indent" . (@about > 1 ? "+- " : " ") . $about->[0]; 123 $buf .= "$indent" . (@about > 1 ? "+- " : " ") . $about->[0];
123 if (@$about > 1) { 124 if (@$about > 1) {
124 if ($seen{$about->[1]+0}++) { 125 if ($seen{ref2ptr $about->[1]}++) {
125 $buf .= " $about->[1], which was seen before.\n"; 126 $buf .= " $about->[1], which was seen before.\n";
126 } else { 127 } else {
127 $buf .= " $about->[1], which is\n"; 128 $buf .= " $about->[1], which is\n";
128 $track->(\$about->[1], $depth - 1, $about == $about[-1] ? "$indent " : "$indent| "); 129 $track->(\$about->[1], $depth - 1, $about == $about[-1] ? "$indent " : "$indent| ");
129 } 130 }
… …
157=cut 158=cut
158 159
159sub find($) { 160sub find($) {
160 my ($about, $excl) = &find_; 161 my ($about, $excl) = &find_;
161 my %excl = map +($_ => undef), @$excl; 162 my %excl = map +($_ => undef), @$excl;
162 grep !exists $excl{$_->[1] + 0}, @$about 163 grep !exists $excl{ref2ptr $_->[1]}, @$about
163} 164}
164 165
165=item $ref = Devel::FindRef::ptr2ref $integer 166=item $ref = Devel::FindRef::ptr2ref $integer
166 167
167Sometimes you know (from debugging output) the address of a perl scalar 168Sometimes you know (from debugging output) the address of a perl scalar
… …
170call on valid addresses, but extremely dangerous to call on invalid ones. 171call on valid addresses, but extremely dangerous to call on invalid ones.
171 172
172 # we know that HASH(0x176ff70) exists, so turn it into a hashref: 173 # we know that HASH(0x176ff70) exists, so turn it into a hashref:
173 my $ref_to_hash = Devel::FindRef::ptr2ref 0x176ff70; 174 my $ref_to_hash = Devel::FindRef::ptr2ref 0x176ff70;
174 175
176=item $ref = Devel::FindRef::ref2ptr $reference
177
178The opposite of C<ptr2ref>, above: returns the internal address of the
179value pointed to by the passed reference. I<No checks whatsoever will be
180done>, so don't use this.
181
175=back 182=back
176 183
177=head1 ENVIRONMENT VARIABLES 184=head1 ENVIRONMENT VARIABLES
178 185
179You can set the environment variable C<PERL_DEVEL_FINDREF_DEPTH> to an 186You can set the environment variable C<PERL_DEVEL_FINDREF_DEPTH> to an

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines