NAME
    JSON::Decode::Marpa - JSON parser using Marpa

VERSION
    This document describes version 0.02 of JSON::Decode::Marpa (from Perl
    distribution JSON-Decode-Marpa), released on 2014-08-27.

SYNOPSIS
     use JSON::Decode::Marpa qw(from_json);
     my $data = from_json(q([1, true, "a", {"b":null}]));

DESCRIPTION
    This module is based on MarpaX::Demo::JSONParser (using "json.2.bnf"),
    but offers a more convenient interface for JSON decoding. I packaged
    this for casual benchmarking against Pegex::JSON and
    JSON::Decode::Regexp.

    The result on my computer: Pegex::JSON and JSON::Decode::Marpa are
    roughly the same speed (but Pegex has a much smaller startup overhead
    than Marpa). JSON::Decode::Regexp is about an order of magnitude faster
    than this module, and JSON::XS is about *three orders of magnitude*
    faster. So that's that.

    This is the benchmark code used:

     use 5.010;
     use strict;
     use warnings;

     use Benchmark qw(timethese);
     use JSON::Decode::Marpa ();
     use JSON::Decode::Regexp ();
     use JSON::XS ();
     use Pegex::JSON;

     my $json = q([1,"abc\ndef",-2.3,null,[],[1,2,3],{},{"a":1,"b":2}]);
     my $pgx  = Pegex::JSON->new;

     timethese -0.5, {
         pegex  => sub { $pgx->load($json) },
         regexp => sub { JSON::Decode::Regexp::from_json($json) },
         marpa  => sub { JSON::Decode::Marpa::from_json($json) },
         xs     => sub { JSON::XS::decode_json($json) },
     };

FUNCTIONS
  from_json($str) => DATA
    Decode JSON in $str. Dies on error.

FAQ
SEE ALSO
    JSON, JSON::PP, JSON::XS, JSON::Tiny, JSON::Decode::Regexp, Pegex::JSON.

HOMEPAGE
    Please visit the project's homepage at
    <https://metacpan.org/release/JSON-Decode-Marpa>.

SOURCE
    Source repository is at
    <https://github.com/perlancar/perl-JSON-Decode-Marpa>.

BUGS
    Please report any bugs or feature requests on the bugtracker website
    <https://rt.cpan.org/Public/Dist/Display.html?Name=JSON-Decode-Marpa>

    When submitting a bug or request, please include a test-file or a patch
    to an existing test-file that illustrates the bug or desired feature.

AUTHOR
    perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2014 by perlancar@cpan.org.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.