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.12.3                                       2011-03-02                           AnyEvent::Serialize(3pm)