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.96 by root, Wed Mar 26 01:40:42 2008 UTC vs.
Revision 1.97 by root, Wed Mar 26 01:43:14 2008 UTC

727objects or arrays, instead they must be concatenated back-to-back. If 727objects or arrays, instead they must be concatenated back-to-back. If
728an error occurs, an exception will be raised as in the scalar context 728an error occurs, an exception will be raised as in the scalar context
729case. Note that in this case, any previously-parsed JSON texts will be 729case. Note that in this case, any previously-parsed JSON texts will be
730lost. 730lost.
731 731
732If there is a parse
733
734=item $lvalue_string = $json->incr_text 732=item $lvalue_string = $json->incr_text
735 733
736This method returns the currently stored JSON fragment as an lvalue, that 734This method returns the currently stored JSON fragment as an lvalue, that
737is, you can manipulate it. This I<only> works when a preceding call to 735is, you can manipulate it. This I<only> works when a preceding call to
738C<incr_parse> in I<scalar context> successfully returned an object. Under 736C<incr_parse> in I<scalar context> successfully returned an object. Under
742method before having parsed anything. 740method before having parsed anything.
743 741
744This function is useful in two cases: a) finding the trailing text after a 742This function is useful in two cases: a) finding the trailing text after a
745JSON object or b) parsing multiple JSON objects separated by non-JSON text 743JSON object or b) parsing multiple JSON objects separated by non-JSON text
746(such as commas). 744(such as commas).
745
746=item $json->incr_skip
747
748This will reset the state of the incremental parser and will remove the
749parsed text from the input buffer. This is useful after C<incr_parse>
750died, in which case the input buffer and incremental parser state is left
751unchanged, to skip the text parsed so far and to reset the parse state.
747 752
748=back 753=back
749 754
750=head2 LIMITATIONS 755=head2 LIMITATIONS
751 756

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines