diff -r c2d05cf1a062 -r a2757c6427cc docs/Writerside/topics/json.h.md --- a/docs/Writerside/topics/json.h.md Wed Dec 31 15:25:30 2025 +0100 +++ b/docs/Writerside/topics/json.h.md Wed Dec 31 16:01:08 2025 +0100 @@ -3,7 +3,7 @@ The UCX JSON API allows [parsing](#parser) and [formatting](#writer) of JSON data. The parser API is similar to the [properties](properties.h.md) parser, -but - due to the nature of JSON - is not allocation-free. +but - due to the nature of JSON - it is not allocation-free. ## Parser @@ -41,7 +41,7 @@ The actual parsing is an interleaving invocation of the `cxJsonFill()` (or `cxJsonFilln()`) and `cxJsonNext()` functions. The `cxJsonFill()` function is a convenience function that accepts UCX strings and normal zero-terminated C strings. -Calling `cxJsonNext()` will return with `CX_JSON_NO_ERROR` (= zero) for each JSON value that is successfully parsed, +Calling `cxJsonNext()` will return with `CX_JSON_NO_ERROR` (= zero) for each JSON value that is successfully parsed and stores the pointer to the allocated value in the variable pointed to by `value`. > The parser is capable of parsing multiple consecutive JSON values. @@ -49,7 +49,7 @@ When all the data from the input buffer was successfully consumed, `cxJsonNext()` returns `CX_JSON_NO_DATA`. -If `cxJsonNext()` returns `CX_JSON_INCOMPLETE_DATA` it means that the input buffer is exhausted, +If `cxJsonNext()` returns `CX_JSON_INCOMPLETE_DATA`, the input buffer is exhausted, but the parsed input does not constitute a complete JSON value. In that case, you can call `cxJsonFill()` again to add more data and continue with `cxJsonNext()`. @@ -144,7 +144,7 @@ > `cxJsonIsFalse()` _only_ returns true, if the value is a literal `false`. >{style="note"} -The `cxJsonAsXYZ()` family of functions return the value with its corresponding C type. +The `cxJsonAsXYZ()` functions return the value with its corresponding plain type. The functions `cxJsonAsInteger()` and `cxJsonAsDouble()` can be used for any number value. For example, if `cxJsonAsInteger()` is used on a non-integral number, a double-to-int conversion is performed.