| … | |
… | |
| 20 | $perl_scalar = $coder->decode ($unicode_json_text); |
20 | $perl_scalar = $coder->decode ($unicode_json_text); |
| 21 | |
21 | |
| 22 | # Note that JSON version 2.0 and above will automatically use JSON::XS |
22 | # Note that JSON version 2.0 and above will automatically use JSON::XS |
| 23 | # if available, at virtually no speed overhead either, so you should |
23 | # if available, at virtually no speed overhead either, so you should |
| 24 | # be able to just: |
24 | # be able to just: |
| 25 | |
25 | |
| 26 | use JSON; |
26 | use JSON; |
| 27 | |
27 | |
| 28 | # and do the same things, except that you have a pure-perl fallback now. |
28 | # and do the same things, except that you have a pure-perl fallback now. |
| 29 | |
29 | |
| 30 | DESCRIPTION |
30 | DESCRIPTION |
| 31 | This module converts Perl data structures to JSON and vice versa. Its |
31 | This module converts Perl data structures to JSON and vice versa. Its |
| … | |
… | |
| 377 | it is disabled, the same hash might be encoded differently even if |
377 | it is disabled, the same hash might be encoded differently even if |
| 378 | contains the same data, as key-value pairs have no inherent ordering |
378 | contains the same data, as key-value pairs have no inherent ordering |
| 379 | in Perl. |
379 | in Perl. |
| 380 | |
380 | |
| 381 | This setting has no effect when decoding JSON texts. |
381 | This setting has no effect when decoding JSON texts. |
|
|
382 | |
|
|
383 | This setting has currently no effect on tied hashes. |
| 382 | |
384 | |
| 383 | $json = $json->allow_nonref ([$enable]) |
385 | $json = $json->allow_nonref ([$enable]) |
| 384 | $enabled = $json->get_allow_nonref |
386 | $enabled = $json->get_allow_nonref |
| 385 | If $enable is true (or missing), then the "encode" method can |
387 | If $enable is true (or missing), then the "encode" method can |
| 386 | convert a non-reference into its corresponding string, number or |
388 | convert a non-reference into its corresponding string, number or |
| … | |
… | |
| 1151 | my $yaml = $to_yaml->encode ($ref) . "\n"; |
1153 | my $yaml = $to_yaml->encode ($ref) . "\n"; |
| 1152 | |
1154 | |
| 1153 | This will *usually* generate JSON texts that also parse as valid YAML. |
1155 | This will *usually* generate JSON texts that also parse as valid YAML. |
| 1154 | Please note that YAML has hardcoded limits on (simple) object key |
1156 | Please note that YAML has hardcoded limits on (simple) object key |
| 1155 | lengths that JSON doesn't have and also has different and incompatible |
1157 | lengths that JSON doesn't have and also has different and incompatible |
| 1156 | unicode handling, so you should make sure that your hash keys are |
1158 | unicode character escape syntax, so you should make sure that your hash |
| 1157 | noticeably shorter than the 1024 "stream characters" YAML allows and |
1159 | keys are noticeably shorter than the 1024 "stream characters" YAML |
| 1158 | that you do not have characters with codepoint values outside the |
1160 | allows and that you do not have characters with codepoint values outside |
| 1159 | Unicode BMP (basic multilingual page). YAML also does not allow "\/" |
1161 | the Unicode BMP (basic multilingual page). YAML also does not allow "\/" |
| 1160 | sequences in strings (which JSON::XS does not *currently* generate, but |
1162 | sequences in strings (which JSON::XS does not *currently* generate, but |
| 1161 | other JSON generators might). |
1163 | other JSON generators might). |
| 1162 | |
1164 | |
| 1163 | There might be other incompatibilities that I am not aware of (or the |
1165 | There might be other incompatibilities that I am not aware of (or the |
| 1164 | YAML specification has been changed yet again - it does so quite often). |
1166 | YAML specification has been changed yet again - it does so quite often). |
| … | |
… | |
| 1180 | of its proponents, I would kindly suggest reading the JSON spec |
1182 | of its proponents, I would kindly suggest reading the JSON spec |
| 1181 | (which is not that difficult or long) and finally make YAML |
1183 | (which is not that difficult or long) and finally make YAML |
| 1182 | compatible to it, and educating users about the changes, instead of |
1184 | compatible to it, and educating users about the changes, instead of |
| 1183 | spreading lies about the real compatibility for many *years* and |
1185 | spreading lies about the real compatibility for many *years* and |
| 1184 | trying to silence people who point out that it isn't true. |
1186 | trying to silence people who point out that it isn't true. |
|
|
1187 | |
|
|
1188 | Addendum/2009: the YAML 1.2 spec is still incomaptible with JSON, |
|
|
1189 | even though the incompatibilities have been documented (and are |
|
|
1190 | known to Brian) for many years and the spec makes explicit claims |
|
|
1191 | that YAML is a superset of JSON. It would be so easy to fix, but |
|
|
1192 | apparently, bullying and corrupting userdata is so much easier. |
| 1185 | |
1193 | |
| 1186 | SPEED |
1194 | SPEED |
| 1187 | It seems that JSON::XS is surprisingly fast, as shown in the following |
1195 | It seems that JSON::XS is surprisingly fast, as shown in the following |
| 1188 | tables. They have been generated with the help of the "eg/bench" program |
1196 | tables. They have been generated with the help of the "eg/bench" program |
| 1189 | in the JSON::XS distribution, to make it easy to compare on your own |
1197 | in the JSON::XS distribution, to make it easy to compare on your own |
