--- JSON-XS/XS.pm 2008/09/29 03:09:27 1.112 +++ JSON-XS/XS.pm 2009/01/21 05:34:08 1.114 @@ -104,7 +104,7 @@ no warnings; use strict; -our $VERSION = '2.23'; +our $VERSION = '2.231'; our @ISA = qw(Exporter); our @EXPORT = qw(encode_json decode_json to_json from_json); @@ -768,17 +768,21 @@ =item $json->incr_skip -This will reset the state of the incremental parser and will remove the -parsed text from the input buffer. This is useful after C -died, in which case the input buffer and incremental parser state is left -unchanged, to skip the text parsed so far and to reset the parse state. +This will reset the state of the incremental parser and will remove +the parsed text from the input buffer so far. This is useful after +C died, in which case the input buffer and incremental parser +state is left unchanged, to skip the text parsed so far and to reset the +parse state. + +The difference to C is that only text until the parse error +occured is removed. =item $json->incr_reset This completely resets the incremental parser, that is, after this call, it will be as if the parser had never parsed anything. -This is useful if you want ot repeatedly parse JSON objects and want to +This is useful if you want to repeatedly parse JSON objects and want to ignore any trailing data, which means you have to reset the parser after each successful decode.