[sr-dev] git:master:2471d1db: jansson Add explaination of error handling.

Module: kamailio Branch: master Commit: 2471d1db579089f9e46feabe59830c53ac862e72 URL: https://github.com/kamailio/kamailio/commit/2471d1db579089f9e46feabe59830c5… Author: Olle E. Johansson &lt;oej(a)edvina.net&gt; Committer: Olle E. Johansson &lt;oej(a)edvina.net&gt; Date: 2015-10-02T13:33:46+03:00 jansson Add explaination of error handling. The pvar remains unchanged if the key/path is not found. Any previous value remains, and it's not reset to a default value or NULL. --- Modified: modules/jansson/README Modified: modules/jansson/doc/jansson_admin.xml --- Diff: https://github.com/kamailio/kamailio/commit/2471d1db579089f9e46feabe59830c5… Patch: https://github.com/kamailio/kamailio/commit/2471d1db579089f9e46feabe59830c5… --- diff --git a/modules/jansson/README b/modules/jansson/README index c5be0a6..87d28a8 100644 --- a/modules/jansson/README +++ b/modules/jansson/README @@ -111,7 +111,9 @@ Chapter 1. Admin Guide foo.bar[0][1].baz). The function can put a string, integer, null, or new json string into - destination. + destination. If the key/path can't be found in the JSON data structure, + the pvar is not changed. If it had a previous value, that value remains + unchanged. Example 1.1. jansson_get usage ... diff --git a/modules/jansson/doc/jansson_admin.xml b/modules/jansson/doc/jansson_admin.xml index b1b0eab..baab686 100644 --- a/modules/jansson/doc/jansson_admin.xml +++ b/modules/jansson/doc/jansson_admin.xml @@ -67,13 +67,15 @@ <function moreinfo="none">jansson_get(key/path, src, dst)</function> </title> <para> - Copy the value at the location 'path' from the json object 'src' and store it in pvar 'dst'. + Copy the value at the location 'path' from the json object 'src' and store it in pvar 'dst'. </para> <para> The path string supports dot delimited notation (e.g. foo.bar.baz), array notation (e.g. [0]), or a combination of the two (e.g. foo.bar[0][1].baz). </para> <para> The function can put a string, integer, null, or new json string into destination. + If the key/path can't be found in the JSON data structure, the pvar is not changed. If it had a previous + value, that value remains unchanged. </para> <example> <title><function>jansson_get</function> usage</title>