[ViewVC] Diff of: cvs/JSON-XS/XS.pm

Comparing JSON-XS/XS.pm (file contents):
Revision 1.33 by root, Wed May 9 16:10:37 2007 UTC vs.
Revision 1.34 by root, Wed May 9 16:33:53 2007 UTC

 package JSON::XS;
 use strict;
 BEGIN {
-   our $VERSION = '1.12';
+   our $VERSION = '1.2';
    our @ISA = qw(Exporter);
    our @EXPORT = qw(to_json from_json objToJson jsonToObj);
    require Exporter;
 JSON numbers and strings become simple Perl scalars. JSON arrays become
 Perl arrayrefs and JSON objects become Perl hashrefs. C<true> becomes
 C<1>, C<false> becomes C<0> and C<null> becomes C<undef>.
+=item ($perl_scalar, $characters) = $json->decode_prefix ($json_text)
+This works like the C<decode> method, but instead of raising an exception
+when there is trailing garbage after the first JSON object, it will
+silently stop parsing there and return the number of characters consumed
+so far.
+This is useful if your JSON texts are not delimited by an outer protocol
+(which is not the brightest thing to do in the first place) and you need
+to know where the JSON text ends.
+   JSON::XS->new->decode_prefix ("[1] the tail")
+   => ([], 3)
 =back
 =head1 MAPPING

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