diff --git a/doc/apiref.rst b/doc/apiref.rst index 84a0233..f11960d 100644 --- a/doc/apiref.rst +++ b/doc/apiref.rst @@ -264,8 +264,6 @@ U+10FFFF are allowed. UTF-8. Use this function only if you are certain that this really is the case (e.g. you have already checked it by other means). - .. versionadded:: 1.2 - .. function:: const char *json_string_value(const json_t *string) Returns the associated value of *string* as a null terminated UTF-8 @@ -277,8 +275,6 @@ U+10FFFF are allowed. valid UTF-8 encoded Unicode string. Returns 0 on success and -1 on error. - .. versionadded:: 1.1 - .. function:: int json_string_set_nocheck(const json_t *string, const char *value) Like :func:`json_string_set`, but doesn't check that *value* is @@ -286,8 +282,6 @@ U+10FFFF are allowed. really is the case (e.g. you have already checked it by other means). - .. versionadded:: 1.2 - Number ====== @@ -353,8 +347,6 @@ information, see :ref:`rfc-conformance`. Sets the associated value of *integer* to *value*. Returns 0 on success and -1 if *integer* is not a JSON integer. - .. versionadded:: 1.1 - .. function:: json_t *json_real(double value) .. refcounting:: new @@ -371,8 +363,6 @@ information, see :ref:`rfc-conformance`. Sets the associated value of *real* to *value*. Returns 0 on success and -1 if *real* is not a JSON real. - .. versionadded:: 1.1 - In addition to the functions above, there's a common query function for integers and reals: @@ -423,8 +413,6 @@ A JSON array is an ordered collection of other JSON values. This is useful when *value* is newly created and not used after the call. - .. versionadded:: 1.1 - .. function:: int json_array_append(json_t *array, json_t *value) Appends *value* to the end of *array*, growing the size of *array* @@ -436,46 +424,34 @@ A JSON array is an ordered collection of other JSON values. *value*. This is useful when *value* is newly created and not used after the call. - .. versionadded:: 1.1 - .. function:: int json_array_insert(json_t *array, size_t index, json_t *value) Inserts *value* to *array* at position *index*, shifting the elements at *index* and after it one position towards the end of the array. Returns 0 on success and -1 on error. - .. versionadded:: 1.1 - .. function:: int json_array_insert_new(json_t *array, size_t index, json_t *value) Like :func:`json_array_insert()` but steals the reference to *value*. This is useful when *value* is newly created and not used after the call. - .. versionadded:: 1.1 - .. function:: int json_array_remove(json_t *array, size_t index) Removes the element in *array* at position *index*, shifting the elements after *index* one position towards the start of the array. Returns 0 on success and -1 on error. - .. versionadded:: 1.1 - .. function:: int json_array_clear(json_t *array) Removes all elements from *array*. Returns 0 on sucess and -1 on error. - .. versionadded:: 1.1 - .. function:: int json_array_extend(json_t *array, json_t *other_array) Appends all elements in *other_array* to the end of *array*. Returns 0 on success and -1 on error. - .. versionadded:: 1.1 - Object ====== @@ -495,8 +471,6 @@ Unicode string and the value is any JSON value. Returns the number of elements in *object*, or 0 if *object* is not a JSON object. - .. versionadded:: 1.1 - .. function:: json_t *json_object_get(const json_t *object, const char *key) .. refcounting:: borrow @@ -518,16 +492,12 @@ Unicode string and the value is any JSON value. really is the case (e.g. you have already checked it by other means). - .. versionadded:: 1.2 - .. function:: int json_object_set_new(json_t *object, const char *key, json_t *value) Like :func:`json_object_set()` but steals the reference to *value*. This is useful when *value* is newly created and not used after the call. - .. versionadded:: 1.1 - .. function:: int json_object_set_new_nocheck(json_t *object, const char *key, json_t *value) Like :func:`json_object_set_new`, but doesn't check that *key* is @@ -535,8 +505,6 @@ Unicode string and the value is any JSON value. really is the case (e.g. you have already checked it by other means). - .. versionadded:: 1.2 - .. function:: int json_object_del(json_t *object, const char *key) Delete *key* from *object* if it exists. Returns 0 on success, or @@ -548,15 +516,11 @@ Unicode string and the value is any JSON value. Remove all elements from *object*. Returns 0 on success and -1 if *object* is not a JSON object. - .. versionadded:: 1.1 - .. function:: int json_object_update(json_t *object, json_t *other) Update *object* with the key-value pairs from *other*, overwriting existing keys. Returns 0 on success or -1 on error. - .. versionadded:: 1.1 - The following functions implement an iteration protocol for objects: @@ -573,8 +537,6 @@ The following functions implement an iteration protocol for objects: *object* only yields all key-value pairs of the object if *key* happens to be the first key in the underlying hash table. - .. versionadded:: 1.3 - .. function:: void *json_object_iter_next(json_t *object, void *iter) Returns an iterator pointing to the next key-value pair in *object* @@ -596,16 +558,12 @@ The following functions implement an iteration protocol for objects: Set the value of the key-value pair in *object*, that is pointed to by *iter*, to *value*. - .. versionadded:: 1.3 - .. function:: int json_object_iter_set_new(json_t *object, void *iter, json_t *value) Like :func:`json_object_iter_set()`, but steals the reference to *value*. This is useful when *value* is newly created and not used after the call. - .. versionadded:: 1.3 - The iteration protocol can be used for example as follows:: /* obj is a JSON object */ @@ -651,30 +609,22 @@ can be ORed together to obtain *flags*. and values to ``":"``. Without this flag, the corresponding separators are ``", "`` and ``": "`` for more readable output. - .. versionadded:: 1.2 - ``JSON_ENSURE_ASCII`` If this flag is used, the output is guaranteed to consist only of ASCII characters. This is achived by escaping all Unicode characters outside the ASCII range. - .. versionadded:: 1.2 - ``JSON_SORT_KEYS`` If this flag is used, all the objects in output are sorted by key. This is useful e.g. if two JSON texts are diffed or visually compared. - .. versionadded:: 1.2 - ``JSON_PRESERVE_ORDER`` If this flag is used, object keys in the output are sorted into the same order in which they were first inserted to the object. For example, decoding a JSON text and then encoding with this flag preserves the order of object keys. - .. versionadded:: 1.3 - The following functions perform the actual JSON encoding. The result is in UTF-8. @@ -842,8 +792,6 @@ equal. Returns 0 if they are inequal or one or both of the pointers are *NULL*. - .. versionadded:: 1.2 - Copying ======= @@ -866,12 +814,8 @@ copied in a recursive fashion. Returns a shallow copy of *value*, or *NULL* on error. - .. versionadded:: 1.2 - .. function:: json_t *json_deep_copy(json_t *value) .. refcounting:: new Returns a deep copy of *value*, or *NULL* on error. - - .. versionadded:: 1.2