--- CBOR-XS/XS.pm 2020/12/11 06:03:40 1.79 +++ CBOR-XS/XS.pm 2020/12/11 06:10:26 1.81 @@ -706,7 +706,7 @@ =head2 TYPE CASTS B: As an experimental extension, C allows you to -force specific cbor types to be used when encoding. That allows you to +force specific CBOR types to be used when encoding. That allows you to encode types not normally accessible (e.g. half floats) as well as force string types even when C is in effect. @@ -758,7 +758,7 @@ =item CBOR::XS::as_cbor $cbor_text -Not a type cast per-se, this type cast forces the argument to eb encoded +Not a type cast per-se, this type cast forces the argument to be encoded as-is. This can be used to embed pre-encoded CBOR data. Note that no checking on the validity of the C<$cbor_text> is done - it's @@ -768,12 +768,16 @@ Treat the array reference as key value pairs and output a CBOR map. This allows you to generate CBOR maps with arbitrary key types (or, if you -don't care about semantics, duplicate keys or prairs in a custom order), +don't care about semantics, duplicate keys or pairs in a custom order), which is otherwise hard to do with Perl. The single argument must be an array reference with an even number of elements. +Note that only the reference to the array is copied, the array itself is +not. Modifications done to the array before calling an encoding function +will be reflected in the encoded output. + Example: encode a CBOR map with a string and an integer as keys. encode_cbor CBOR::XS::as_map [string => "value", 5 => "value"]