Pullup ticket #3518.
[pkgsrcv2.git] / devel / p5-Storable / DESCR
1 The Storable extension brings persistency to your data.
2
3 You may recursively store to disk any data structure, no matter
4 how complex and circular it is, provided it contains only SCALAR,
5 ARRAY, HASH (possibly tied) and references (possibly blessed) to
6 those items.
7
8 At a later stage, or in another program, you may retrieve data from
9 the stored file and recreate the same hiearchy in memory. If you
10 had blessed references, the retrieved references are blessed into
11 the same package, so you must make sure you have access to the same
12 perl class as the one used to create the relevant objects.
13
14 There is also a dclone() routine which performs an optimized
15 mirroring of any data structure, preserving its topology.
16
17 Objects (blessed references) may also redefine the way storage and
18 retrieval is performed, and/or what deep cloning should do on those
19 objects.