1autobox::dump(3) User Contributed Perl Documentation autobox::dump(3)
2
3
4
6 autobox::dump - human/perl readable strings from the results of an EXPR
7
9 Version 20090426.1746
10
12 The autobox::dump pragma adds, via the autobox pragma, a method to
13 normal expression (such as scalars, arrays, hashes, math, literals,
14 etc.) that produces a human/perl readable representation of the value
15 of that expression.
16
17 use autobox::dump;
18
19 my $foo = "foo";
20 print $foo->perl; # "foo";
21
22 print +(5*6)->perl; # 30;
23
24 my @a = (1..3);
25
26 print @a->perl;
27 # [
28 # 1,
29 # 2,
30 # 3
31 # ];
32
33 print {a=>1, b=>2}->perl;
34 # {
35 # "a" => 1,
36 # "b" => 2
37 # };
38
39 sub func {
40 my ($x, $y) = @_;
41 return $x + $y;
42 }
43
44 my $func = \&func;
45 print $func->perl;
46 #sub {
47 # BEGIN {
48 # $^H{'autobox_scope'} = q(154456408);
49 # $^H{'autobox'} = q(HASH(0x93a3e00));
50 # $^H{'autobox_leave'} = q(Scope::Guard=ARRAY(0x9435078));
51 # }
52 # my($x, $y) = @_;
53 # return $x + $y;
54 #}
55
56 You can set Data::Dumper options by passing either arrayrefs of option
57 and value pairs or just keys (in which case the option will be set to
58 1). The default options are C<qw/Indent Terse Useqq Sortkeys Deparse/>.
59
60 print ["a", 0, 1]->perl([Indent => 3], [Varname => "a"], qw/Useqq/);
61 #$a1 = [
62 # #0
63 # "a",
64 # #1
65 # 0,
66 # #2
67 # 1
68 # ];
69
70 You can also call the class method ->options to set a different default.
71
72 #set Indent to 0, but leave the rest of the options
73 autobox::dump->options([Indent => 0], qw/Terse Useqq Sortkeys Deparse/);
74
75 print ["a", 0, 1]->perl; #["a",0,1]
76
78 Chas. J Owens IV, "<chas.owens at gmail.com>"
79
81 Has all the issues autobox has.
82
83 Has all the issues Data::Dumper has.
84
85 This pragma errs on the side of human readable to the detriment of Perl
86 readable. In particular it uses the terse and deparse options of
87 Data::Dumper by default. These options may create code that cannot be
88 eval'ed. For best eval results, set options to "qw/Purity/". Note,
89 this turns off coderef dumping.
90
91 Please report any bugs or feature requests to
92 http://github.com/cowens/autobox-dump/issues
93
95 You can find documentation for this module with the perldoc command.
96
97 perldoc autobox::dump
98
100 Michael Schwern for starting the perl5i pragma which prompted me to add
101 a feature I wanted to autobox.
102
104 Copyright 2009 Chas. J Owens IV, all rights reserved.
105
106 This program is free software; you can redistribute it and/or modify it
107 under the same terms as Perl itself.
108
109
110
111perl v5.30.1 2020-01-30 autobox::dump(3)