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