1Data::Dump(3) User Contributed Perl Documentation Data::Dump(3)
2
3
4
6 Data::Dump - Pretty printing of data structures
7
9 use Data::Dump qw(dump);
10
11 $str = dump(@list)
12 @copy_of_list = eval $str;
13
15 This module provides a single function called dump() that takes a list
16 of values as its argument and produces a string as its result. The
17 string contains Perl code that, when "eval"ed, produces a deep copy of
18 the original arguments. The string is formatted for easy reading.
19
20 If dump() is called in a void context, then the dump is printed on
21 STDERR instead of being returned.
22
23 If you don't like importing a function that overrides Perl's not-so-
24 useful builtin, then you can also import the same function as pp(),
25 mnemonic for "pretty-print".
26
28 The "Data::Dump" module grew out of frustration with Sarathy's in-most-
29 cases-excellent "Data::Dumper". Basic ideas and some code are shared
30 with Sarathy's module.
31
32 The "Data::Dump" module provides a much simpler interface than
33 "Data::Dumper". No OO interface is available and there are no configuā
34 ration options to worry about (yet :-). The other benefit is that the
35 dump produced does not try to set any variables. It only returns what
36 is needed to produce a copy of the arguments. This means that
37 "dump("foo")" simply returns "foo", and "dump(1..5)" simply returns
38 "(1, 2, 3, 4, 5)".
39
41 Data::Dumper, Storable
42
44 The "Data::Dump" module is written by Gisle Aas <gisle@aas.no>, based
45 on "Data::Dumper" by Gurusamy Sarathy <gsar@umich.edu>.
46
47 Copyright 1998-2000,2003-2004 Gisle Aas.
48 Copyright 1996-1998 Gurusamy Sarathy.
49
50 This library is free software; you can redistribute it and/or modify it
51 under the same terms as Perl itself.
52
53
54
55perl v5.8.8 2006-11-29 Data::Dump(3)