manpagez: man pages & more
man Mojo::JSON::Pointer(3)
Home | html | info | man
Mojo::JSON::Pointer(3)



NAME

       Mojo::JSON::Pointer - JSON Pointers


SYNOPSIS

         use Mojo::JSON::Pointer;

         my $pointer = Mojo::JSON::Pointer->new({foo => [23, 'bar']});
         say $pointer->get('/foo/1');
         say 'Contains "/foo".' if $pointer->contains('/foo');


DESCRIPTION

       Mojo::JSON::Pointer is an implementation of RFC 6901
       <https://tools.ietf.org/html/rfc6901>.


ATTRIBUTES

       Mojo::JSON::Pointer implements the following attributes.

   data
         my $data = $pointer->data;
         $pointer = $pointer->data({foo => 'bar'});

       Data structure to be processed.


METHODS

       Mojo::JSON::Pointer inherits all methods from Mojo::Base and implements
       the following new ones.

   contains
         my $bool = $pointer->contains('/foo/1');

       Check if "data" contains a value that can be identified with the given
       JSON Pointer.

         # True
         Mojo::JSON::Pointer->new('just a string')->contains('');
         Mojo::JSON::Pointer->new({'aY' => 'mojolicious'})->contains('/aY');
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/foo');
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/baz/1');

         # False
         Mojo::JSON::Pointer->new({'aY' => 'mojolicious'})->contains('/a');
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/bar');
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/baz/9');

   get
         my $value = $pointer->get('/foo/bar');

       Extract value from "data" identified by the given JSON Pointer.

         # "just a string"
         Mojo::JSON::Pointer->new('just a string')->get('');

         # "mojolicious"
         Mojo::JSON::Pointer->new({'aY' => 'mojolicious'})->get('/aY');

         # "bar"
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5, 6]})->get('/foo');

         # "4"
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5, 6]})->get('/baz/0');

         # "6"
         Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5, 6]})->get('/baz/2');

   new
         my $pointer = Mojo::JSON::Pointer->new;
         my $pointer = Mojo::JSON::Pointer->new({foo => 'bar'});

       Build new Mojo::JSON::Pointer object.


SEE ALSO

       Mojolicious(3), Mojolicious::Guides(3), <https://mojolicious.org>.



perl v5.32.1                      2021-12-08            Mojo::JSON::Pointer(3)

mojolicious 9.260.0 - Generated Mon May 30 15:49:40 CDT 2022
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.