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

Comparing JSON-XS/XS.pm (file contents):
Revision 1.20 by root, Sun Mar 25 00:47:42 2007 UTC vs.
Revision 1.21 by root, Sun Mar 25 02:32:40 2007 UTC

… …
8 8
9 # exported functions, croak on error 9 # exported functions, croak on error
10 10
11 $utf8_encoded_json_text = to_json $perl_hash_or_arrayref; 11 $utf8_encoded_json_text = to_json $perl_hash_or_arrayref;
12 $perl_hash_or_arrayref = from_json $utf8_encoded_json_text; 12 $perl_hash_or_arrayref = from_json $utf8_encoded_json_text;
13
14 # objToJson and jsonToObj are exported for JSON
15 # compatibility, but should not be used in new code.
13 16
14 # oo-interface 17 # oo-interface
15 18
16 $coder = JSON::XS->new->ascii->pretty->allow_nonref; 19 $coder = JSON::XS->new->ascii->pretty->allow_nonref;
17 $pretty_printed_unencoded = $coder->encode ($perl_scalar); 20 $pretty_printed_unencoded = $coder->encode ($perl_scalar);
… …
36 39
37=head2 FEATURES 40=head2 FEATURES
38 41
39=over 4 42=over 4
40 43
41=item * correct handling of unicode issues 44=item * correct unicode handling
42 45
43This module knows how to handle Unicode, and even documents how and when 46This module knows how to handle Unicode, and even documents how and when
44it does so. 47it does so.
45 48
46=item * round-trip integrity 49=item * round-trip integrity
47 50
48When you serialise a perl data structure using only datatypes supported 51When you serialise a perl data structure using only datatypes supported
49by JSON, the deserialised data structure is identical on the Perl level. 52by JSON, the deserialised data structure is identical on the Perl level.
50(e.g. the string "2.0" doesn't suddenly become "2"). 53(e.g. the string "2.0" doesn't suddenly become "2" just because it looks
54like a number).
51 55
52=item * strict checking of JSON correctness 56=item * strict checking of JSON correctness
53 57
54There is no guessing, no generating of illegal JSON texts by default, 58There is no guessing, no generating of illegal JSON texts by default,
55and only JSON is accepted as input by default (the latter is a security 59and only JSON is accepted as input by default (the latter is a security
… …
66interface. 70interface.
67 71
68=item * reasonably versatile output formats 72=item * reasonably versatile output formats
69 73
70You can choose between the most compact guarenteed single-line format 74You can choose between the most compact guarenteed single-line format
71possible (nice for simple line-based protocols), a pure-ascii format (for 75possible (nice for simple line-based protocols), a pure-ascii format
72when your transport is not 8-bit clean), or a pretty-printed format (for 76(for when your transport is not 8-bit clean, still supports the whole
73when you want to read that stuff). Or you can combine those features in 77unicode range), or a pretty-printed format (for when you want to read that
74whatever way you like. 78stuff). Or you can combine those features in whatever way you like.
75 79
76=back 80=back
77 81
78=cut 82=cut
79 83
80package JSON::XS; 84package JSON::XS;
81 85
82use strict; 86use strict;
83 87
84BEGIN { 88BEGIN {
85 our $VERSION = '0.7'; 89 our $VERSION = '0.8';
86 our @ISA = qw(Exporter); 90 our @ISA = qw(Exporter);
87 91
88 our @EXPORT = qw(to_json from_json); 92 our @EXPORT = qw(to_json from_json objToJson jsonToObj);
89 require Exporter; 93 require Exporter;
90 94
91 require XSLoader; 95 require XSLoader;
92 XSLoader::load JSON::XS::, $VERSION; 96 XSLoader::load JSON::XS::, $VERSION;
93} 97}

Diff Legend

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