Bifcode

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        keys must be unique.

    Bifcode::Error::DecodeKeyOrder
        Your data violates the *bifcode* format constaint that dict keys
        must appear in lexical sort order.

    Bifcode::Error::DecodeKeyValue
        Your data contains a dictionary with an odd number of elements.

    Bifcode::Error::DecodeTrailing
        Your data does not end after the first *bifcode*-serialised
        item.

    Bifcode::Error::DecodeUTF8
        Your data contained a UTF8 string with an invalid length.

    Bifcode::Error::DecodeUTF8Trunc
        Your data includes a string declared to be longer than the
        available data.

    Bifcode::Error::DecodeUTF8Term
        Your data includes a UTF8 string that is missing a ","
        terminator.

    Bifcode::Error::DecodeUsage
        You called "decode_bifcode()" with invalid arguments.

    Bifcode::Error::DiffUsage
        You called "diff_bifcode()" with invalid arguments.

    Bifcode::Error::EncodeBytesUndef
        You attempted to encode "undef" as a byte string.

    Bifcode::Error::EncodeFloat
        You attempted to encode something as a float that isn't
        recognised as one.

    Bifcode::Error::EncodeFloatUndef
        You attempted to encode "undef" as a float.

    Bifcode::Error::EncodeInteger
        You attempted to encode something as an integer that isn't
        recognised as one.

    Bifcode::Error::EncodeIntegerUndef
        You attempted to encode "undef" as an integer.

    Bifcode::Error::EncodeUTF8Undef
        You attempted to encode "undef" as a UTF8 string.

    Bifcode::Error::EncodeUnhandled
        You are trying to serialise a data structure that contains a
        data type not supported by the *bifcode* format.

    Bifcode::Error::EncodeUsage
        You called "encode_bifcode()" with invalid arguments.

    Bifcode::Error::ForceUsage
        You called "force_bifcode()" with invalid arguments.

BUGS AND LIMITATIONS
    Strings and numbers are practically indistinguishable in Perl, so
    "encode_bifcode()" has to resort to a heuristic to decide how to
    serialise a scalar. This cannot be fixed.

    At the moment all Perl hash keys are encoded as BIFCODE_UTF8 as I
    have not yet had the need for BIFCODE_BYTES keys or found a cheap,
    obvious way to distinguish the two.

SEE ALSO
    This distribution includes the diff-bifcode command-line utility for
    comparing Bifcodes in files.

AUTHOR
    Mark Lawrence <nomad@null.net>, heavily based on Bencode by
    Aristotle Pagaltzis <pagaltzis@gmx.de>

COPYRIGHT AND LICENSE
    This software is copyright (c):

    *   2015 by Aristotle Pagaltzis

    *   2017-2018 by Mark Lawrence.

    This is free software; you can redistribute it and/or modify it
    under the same terms as the Perl 5 programming language system
    itself.



( run in 2.670 seconds using v1.01-cache-2.11-cpan-df04353d9ac )