diff options
author | Petri Lehtinen <petri@digip.org> | 2019-10-17 13:37:33 +0300 |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-10-17 13:37:33 +0300 |
commit | 25e706cce729678f215cc47fb2c0e85633a77c01 (patch) | |
tree | ae8ef507f52507e368cdc3b86c37fe055d8e28fc /doc | |
parent | 8682f2aab3891a53c30c5b47490a2814cb41f340 (diff) | |
parent | 8b022dad76d44ea5ec01fdeffbd8214eeab88c19 (diff) | |
download | jansson-25e706cce729678f215cc47fb2c0e85633a77c01.zip jansson-25e706cce729678f215cc47fb2c0e85633a77c01.tar.gz jansson-25e706cce729678f215cc47fb2c0e85633a77c01.tar.bz2 |
Merge branch 'master' into fix-issue281
Diffstat (limited to 'doc')
-rw-r--r-- | doc/apiref.rst | 12 | ||||
-rw-r--r-- | doc/tutorial.rst | 2 |
2 files changed, 12 insertions, 2 deletions
diff --git a/doc/apiref.rst b/doc/apiref.rst index 5d8d41b..16f1ecb 100644 --- a/doc/apiref.rst +++ b/doc/apiref.rst @@ -726,6 +726,12 @@ allowed in object keys. The value of any existing key is not changed. Returns 0 on success or -1 on error. +.. function:: int json_object_update_recursive(json_t *object, json_t *other) + + Like :func:`json_object_update()`, but object values in *other* are + recursively merged with the corresponding values in *object* if they are also + objects, instead of overwriting them. Returns 0 on success or -1 on error. + .. function:: json_object_foreach(object, key, value) Iterate over every key-value pair of ``object``, running the block @@ -1351,7 +1357,11 @@ If no error or position information is needed, you can pass *NULL*. It is important to note that this function can only succeed on stream file descriptors (such as SOCK_STREAM). Using this function on a non-stream file descriptor will result in undefined behavior. For - non-stream file descriptors, see instead :func:`json_loadb()`. + non-stream file descriptors, see instead :func:`json_loadb()`. In + addition, please note that this function cannot be used on non-blocking + file descriptors (such as a non-blocking socket). Using this function + on non-blocking file descriptors has a high risk of data loss because + it does not support resuming. This function requires POSIX and fails on all non-POSIX systems. diff --git a/doc/tutorial.rst b/doc/tutorial.rst index 56861c2..bb7a6c2 100644 --- a/doc/tutorial.rst +++ b/doc/tutorial.rst @@ -74,7 +74,7 @@ function:: static char *request(const char *url); -It takes the URL as a parameter, preforms a HTTP GET request, and +It takes the URL as a parameter, performs a HTTP GET request, and returns a newly allocated string that contains the response body. If the request fails, an error message is printed to stderr and the return value is *NULL*. For full details, refer to :download:`the code |