NAME
Sereal::Dclone - Deep (recursive) cloning via Sereal
SYNOPSIS
use Sereal::Dclone 'dclone';
my $cloned = dclone $ref;
DESCRIPTION
Sereal::Dclone provides a "dclone" function modeled after the function
from Storable, using Sereal for fast serialization.
Sereal is presently known to support serializing SCALAR, ARRAY, HASH,
REF, and Regexp references. Sereal will also serialize and recreate
blessed objects, provided the underlying reference type is supported,
or the object class provides FREEZE and THAW serialization methods
("FREEZE/THAW CALLBACK MECHANISM" in Sereal::Encoder). Be cautious with
cloned objects as only the internal data structure is cloned, and the
destructor will still be called when it is destroyed.
FUNCTIONS
Sereal::Dclone provides one function, which is exported on demand.
dclone
my $cloned = dclone $ref;
my $cloned = dclone $ref, {undef_unknown => 1, warn_unknown => 1};
Recursively clones a referenced data structure by serializing and then
deserializing it with Sereal. Unlike Storable's dclone, the argument
can be any serializable scalar, not just a reference. If an unsupported
value is encountered, an exception will be thrown as it cannot be
cloned.
Options can be passed to the underlying Sereal::Encoder object in an
optional hash reference. To prevent exceptions when serializing
unsupported values, the undef_unknown or stringify_unknown options may
be useful. The croak_on_bless or no_bless_objects options can be used
to control cloning of objects. freeze_callbacks is enabled by default.
BUGS
Report any issues on the public bugtracker.
AUTHOR
Dan Book <
[email protected]>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2016 by Dan Book.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
SEE ALSO
Storable, Sereal
