NAME

       JSON::MultiValueOrdered - handle JSON like {"a":1, "a":2}

SYNOPSIS

          use Test::More tests => 4;
          use JSON::MultiValueOrdered;

          my $j = JSON::MultiValueOrdered->new;
          isa_ok $j, 'JSON::Tiny';

          my $data = $j->decode(<<'JSON');
          {
             "a": 1,
             "b": 2,
             "a": 3,
             "b": 4
          }
          JSON

          # As you'd expect, for repeated values, the last value is used
          is_deeply(
             $data,
             { a => 3, b => 4 },
           );

          # But hashes within the structure are tied to Tie::Hash::MultiValueOrdered
          is_deeply(
             [ tied(%$data)->get('b') ],
             [ 2, 4 ],
           );

          # And the extra information from the tied hash is used when re-encoding
          is(
             $j->encode($data),
             q({"a":1,"b":2,"a":3,"b":4}),
          );

          done_testing;

DESCRIPTION

       The JSON specification allows keys to be repeated within objects. It remains silent on how repeated keys
       should be interpreted. Most JSON implementations end up choosing just one of the values; sometimes the
       first, sometimes the last.

       JSON::MultiValueOrdered is a subclass of JSON::Tiny which treats objects as ordered lists of key-value
       pairs, with duplicate keys allowed. It achieves this by returning all hashes as tied using
       Tie::Hash::MultiValueOrdered. While these hashes behave like standard Perl hashes (albeit while
       preserving the original order of the keys), they provide a tied object interface allowing you to retrieve
       additional values for each key.

       JSON::MultiValueOrdered serialisation also serialises these additional values and preserves order.

       JSON::MultiValueOrdered is a subclass of JSON::Tiny::Subclassable and JSON::Tiny, which is itself a fork
       of Mojo::JSON. Except where noted, the methods listed below behave identically to the methods of the same
       names in the superclasses.

   Constructor
       "new(%attributes)"

   Attributes
       "pretty"
       "error"

   Methods
       "decode($bytes)"
       "encode($ref)"
       "false"
       "true"

   Functions
       "j(\@array)" / "j(\%hash)" / "j($bytes)"
           Encode or decode JSON as applicable.

           This  function  may  be exported, but is not exported by default. You may request to import it with a
           different name:

              use JSON::MultiValueOrdered j => { -as => 'quick_json' };

BUGS

       Please report any bugs to <http://rt.cpan.org/Dist/Display.html?Queue=JSON-MultiValueOrdered>.

SEE ALSO

       JSON::Tiny::Subclassable, JSON::Tiny, Mojo::JSON.

       Tie::Hash::MultiValueOrdered.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

       This software is copyright (c) 2012-2013 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES

       THIS  PACKAGE  IS  PROVIDED  "AS  IS"  AND  WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
       LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

perl v5.30.0                                       2020-01-31                       JSON::MultiValueOrdered(3pm)