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.110 by root, Sun Jul 20 17:55:19 2008 UTC vs.
Revision 1.114 by root, Wed Jan 21 05:34:08 2009 UTC

… …
49to write yet another JSON module? While it seems there are many JSON 49to write yet another JSON module? While it seems there are many JSON
50modules, none of them correctly handle all corner cases, and in most cases 50modules, none of them correctly handle all corner cases, and in most cases
51their maintainers are unresponsive, gone missing, or not listening to bug 51their maintainers are unresponsive, gone missing, or not listening to bug
52reports for other reasons. 52reports for other reasons.
53 53
54See COMPARISON, below, for a comparison to some other JSON modules.
55
56See MAPPING, below, on how JSON::XS maps perl values to JSON values and 54See MAPPING, below, on how JSON::XS maps perl values to JSON values and
57vice versa. 55vice versa.
58 56
59=head2 FEATURES 57=head2 FEATURES
60 58
… …
104package JSON::XS; 102package JSON::XS;
105 103
106no warnings; 104no warnings;
107use strict; 105use strict;
108 106
109our $VERSION = '2.2222'; 107our $VERSION = '2.231';
110our @ISA = qw(Exporter); 108our @ISA = qw(Exporter);
111 109
112our @EXPORT = qw(encode_json decode_json to_json from_json); 110our @EXPORT = qw(encode_json decode_json to_json from_json);
113 111
114sub to_json($) { 112sub to_json($) {
… …
768JSON object or b) parsing multiple JSON objects separated by non-JSON text 766JSON object or b) parsing multiple JSON objects separated by non-JSON text
769(such as commas). 767(such as commas).
770 768
771=item $json->incr_skip 769=item $json->incr_skip
772 770
773This will reset the state of the incremental parser and will remove the 771This will reset the state of the incremental parser and will remove
774parsed text from the input buffer. This is useful after C<incr_parse> 772the parsed text from the input buffer so far. This is useful after
775died, in which case the input buffer and incremental parser state is left 773C<incr_parse> died, in which case the input buffer and incremental parser
776unchanged, to skip the text parsed so far and to reset the parse state. 774state is left unchanged, to skip the text parsed so far and to reset the
775parse state.
776
777The difference to C<incr_reset> is that only text until the parse error
778occured is removed.
777 779
778=item $json->incr_reset 780=item $json->incr_reset
779 781
780This completely resets the incremental parser, that is, after this call, 782This completely resets the incremental parser, that is, after this call,
781it will be as if the parser had never parsed anything. 783it will be as if the parser had never parsed anything.
782 784
783This is useful if you want ot repeatedly parse JSON objects and want to 785This is useful if you want to repeatedly parse JSON objects and want to
784ignore any trailing data, which means you have to reset the parser after 786ignore any trailing data, which means you have to reset the parser after
785each successful decode. 787each successful decode.
786 788
787=back 789=back
788 790

Diff Legend

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