| … | |
… | |
| 191 | sharing extension. This also makes it possible to encode cyclic data |
191 | sharing extension. This also makes it possible to encode cyclic data |
| 192 | structures. |
192 | structures. |
| 193 | |
193 | |
| 194 | It is recommended to leave it off unless you know your |
194 | It is recommended to leave it off unless you know your |
| 195 | communication partner supports the value sharing extensions to CBOR |
195 | communication partner supports the value sharing extensions to CBOR |
| 196 | (http://cbor.schmorp.de/value-sharing), as without decoder support, the |
196 | (L<http://cbor.schmorp.de/value-sharing>), as without decoder support, the |
| 197 | resulting data structure might be unusable. |
197 | resulting data structure might be unusable. |
| 198 | |
198 | |
| 199 | Detecting shared values incurs a runtime overhead when values are encoded |
199 | Detecting shared values incurs a runtime overhead when values are encoded |
| 200 | that have a reference counter large than one, and might unnecessarily |
200 | that have a reference counter large than one, and might unnecessarily |
| 201 | increase the encoded size, as potentially shared values are encode as |
201 | increase the encoded size, as potentially shared values are encode as |
| … | |
… | |
| 224 | also results in a very large runtime overhead (expect encoding times to be |
224 | also results in a very large runtime overhead (expect encoding times to be |
| 225 | 2-4 times as high as without). |
225 | 2-4 times as high as without). |
| 226 | |
226 | |
| 227 | It is recommended to leave it off unless you know your |
227 | It is recommended to leave it off unless you know your |
| 228 | communications partner supports the stringref extension to CBOR |
228 | communications partner supports the stringref extension to CBOR |
| 229 | (http://cbor.schmorp.de/stringref), as without decoder support, the |
229 | (L<http://cbor.schmorp.de/stringref>), as without decoder support, the |
| 230 | resulting data structure might not be usable. |
230 | resulting data structure might not be usable. |
| 231 | |
231 | |
| 232 | If C<$enable> is false (the default), then C<encode> will encode strings |
232 | If C<$enable> is false (the default), then C<encode> will encode strings |
| 233 | the standard CBOR way. |
233 | the standard CBOR way. |
| 234 | |
234 | |
| … | |
… | |
| 679 | These tags are always handled when decoding, and their handling cannot be |
679 | These tags are always handled when decoding, and their handling cannot be |
| 680 | overriden by the user. |
680 | overriden by the user. |
| 681 | |
681 | |
| 682 | =over 4 |
682 | =over 4 |
| 683 | |
683 | |
| 684 | =item <unassigned> (perl-object, L<http://cbor.schmorp.de/perl-object>) |
684 | =item 26 (perl-object, L<http://cbor.schmorp.de/perl-object>) |
| 685 | |
685 | |
| 686 | These tags are automatically created (and decoded) for serialisable |
686 | These tags are automatically created (and decoded) for serialisable |
| 687 | objects using the C<FREEZE/THAW> methods (the L<Types::Serialier> object |
687 | objects using the C<FREEZE/THAW> methods (the L<Types::Serialier> object |
| 688 | serialisation protocol). See L<OBJECT SERIALISATION> for details. |
688 | serialisation protocol). See L<OBJECT SERIALISATION> for details. |
| 689 | |
689 | |
| 690 | =item <unassigned>, <unassigned> (sharable, sharedref, L <http://cbor.schmorp.de/value-sharing>) |
690 | =item 28, 29 (sharable, sharedref, L <http://cbor.schmorp.de/value-sharing>) |
| 691 | |
691 | |
| 692 | These tags are automatically decoded when encountered, resulting in |
692 | These tags are automatically decoded when encountered, resulting in |
| 693 | shared values in the decoded object. They are only encoded, however, when |
693 | shared values in the decoded object. They are only encoded, however, when |
| 694 | C<allow_sharable> is enabled. |
694 | C<allow_sharable> is enabled. |
| 695 | |
695 | |
| 696 | =item <unassigned>, <unassigned> (stringref-namespace, stringref, L <http://cbor.schmorp.de/stringref>) |
696 | =item 256, 25 (stringref-namespace, stringref, L <http://cbor.schmorp.de/stringref>) |
| 697 | |
697 | |
| 698 | These tags are automatically decoded when encountered. They are only |
698 | These tags are automatically decoded when encountered. They are only |
| 699 | encoded, however, when C<pack_strings> is enabled. |
699 | encoded, however, when C<pack_strings> is enabled. |
| 700 | |
700 | |
| 701 | =item 22098 (indirection, L<http://cbor.schmorp.de/indirection>) |
701 | =item 22098 (indirection, L<http://cbor.schmorp.de/indirection>) |
