debian man page for anyevent::serialize

AnyEvent::Serialize(3pm)				User Contributed Perl Documentation				  AnyEvent::Serialize(3pm)

NAME
       AnyEvent::Serialize - async serialize/deserialize function

SYNOPSIS
	 use AnyEvent::Serialize ':all';
	 use AnyEvent::Serialize 'serialize';
	 use AnyEvent::Serialize 'deserialize';
	 use AnyEvent::Serialize ... block_size => 666;

	 serialize $object, sub { ($str, $recursion_detected) = @_ };
	 deserialize $string, sub { my ($object, $error, $tail) = @_ }

DESCRIPTION
       Sometimes You need to serialize/deserialize a lot of data. If You do it using Data::Dumper or eval it can take You too much time.  This
       module splits (de)serialization process into fixed-size parts and does this work in non-blocking mode.

       This module uses Data::StreamSerializer and Data::StreamDeserializer to serialize or deserialize Your data.

EXPORT
   serialize($object, $result_callback)
       Serializes Your object. When serialization is done it will call $result_callback. This callback receives two arguments:

       result string
       flag if recursion is detected

   deserialize($str, $result_callback)
       Deserializes Your string. When deserialization is done or an error is detected it will call $result_callback. This callback receives three
       arguments:

       deserialized object
       error string (if an error was occured)
       undeserialized string tail

BREAKING
       You can break serialization/deserialization process if You save value that is returned by functions serialize/deserialize. They return
       guards if they are called in non-void context.

SEE ALSO
       Data::StreamSerializer, Data::StreamDeserializer.

AUTHOR
       Dmitry E. Oboukhov, <unera@debian.org>

COPYRIGHT AND LICENSE
       Copyright (C) 2011 by Dmitry E. Oboukhov

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.10.1							    2011-03-02						  AnyEvent::Serialize(3pm)