ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/CBOR-XS/XS.pm
(Generate patch)

Comparing CBOR-XS/XS.pm (file contents):
Revision 1.8 by root, Sun Oct 27 22:48:12 2013 UTC vs.
Revision 1.9 by root, Mon Oct 28 21:28:14 2013 UTC

… …
26 substr $many_cbor_strings, 0, $length, ""; # remove decoded cbor string 26 substr $many_cbor_strings, 0, $length, ""; # remove decoded cbor string
27 } 27 }
28 28
29=head1 DESCRIPTION 29=head1 DESCRIPTION
30 30
31WARNING! THIS IS A PRE-ALPHA RELEASE! IT WILL CRASH, CORRUPT YOUR DATA 31WARNING! This module is very new, and not very well tested (that's up to
32AND EAT YOUR CHILDREN! (Actually, apart from being untested and a bit 32you to do). Furthermore, details of the implementation might change freely
33feature-limited, it might already be useful). 33before version 1.0. And lastly, the object serialisation protocol depends
34on a pending IANA assignment, and until that assignment is official, this
35implementation is not interoperable with other implementations (even
36future versions of this module) until the assignment is done.
37
38You are still invited to try out CBOR, and this module.
34 39
35This module converts Perl data structures to the Concise Binary Object 40This module converts Perl data structures to the Concise Binary Object
36Representation (CBOR) and vice versa. CBOR is a fast binary serialisation 41Representation (CBOR) and vice versa. CBOR is a fast binary serialisation
37format that aims to use a superset of the JSON data model, i.e. when you 42format that aims to use a superset of the JSON data model, i.e. when you
38can represent something in JSON, you should be able to represent it in 43can represent something in JSON, you should be able to represent it in
39CBOR. 44CBOR.
40 45
41This makes it a faster and more compact binary alternative to JSON, with 46In short, CBOR is a faster and very compact binary alternative to JSON,
42the added ability of supporting serialising of perl objects. 47with the added ability of supporting serialisation of Perl objects.
43 48
44The primary goal of this module is to be I<correct> and the secondary goal 49The primary goal of this module is to be I<correct> and the secondary goal
45is to be I<fast>. To reach the latter goal it was written in C. 50is to be I<fast>. To reach the latter goal it was written in C.
46 51
47See MAPPING, below, on how CBOR::XS maps perl values to CBOR values and 52See MAPPING, below, on how CBOR::XS maps perl values to CBOR values and
… …
51 56
52package CBOR::XS; 57package CBOR::XS;
53 58
54use common::sense; 59use common::sense;
55 60
56our $VERSION = 0.04; 61our $VERSION = 0.05;
57our @ISA = qw(Exporter); 62our @ISA = qw(Exporter);
58 63
59our @EXPORT = qw(encode_cbor decode_cbor); 64our @EXPORT = qw(encode_cbor decode_cbor);
60 65
61use Exporter; 66use Exporter;

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines