# mco_lJSON_obj_add_uint
RT

### Prototype

        MCO_RET mco_lJSON_obj_add_uint(lews_JSON_context_h json_ctx, const char *key, mco_uint8 value);

### Arguments

`json_ctx`
Pointer to an initialized `lews_JSON_context_t` structure.
`key`
Null-terminated string specifying the name of the JSON field to be added.
`value`
Unsigned 64-bit integer value to be assigned to the field.

### Description

> This function adds an unsigned numeric key-value pair to the current JSON object (e.g., `"value": 42`).

> The value is converted to its decimal string representation and inserted without quotes, as required by the JSON standard.

> The function may trigger a buffer flush and send data over the network if there is insufficient space in the output buffer to write the formatted key-value pair.

> This function can only be called when the current context is inside a JSON object. Attempting to call it at the root level or inside an array will result in an error.

>         ...
>         ret = mco_lJSON_obj_open_obj(&json_ctx, "metrics");
>         if (ret == MCO_S_OK) {
>             ret = mco_lJSON_obj_add_uint(&json_ctx, "value", 42);
>             if (ret != MCO_S_OK) {
>                 printf("mco_lJSON_obj_add_uint error %d\n", ret);
>             }
>             ret = mco_lJSON_obj_close(&json_ctx);
>             if (ret != MCO_S_OK) {
>                 printf("mco_lJSON_obj_close error %d\n", ret);
>             }
>         }
>         ...

### Return Codes

`MCO_S_OK`
Unsigned numeric key-value pair successfully added to the current JSON object.
`MCO_E_NW_SENDERR`
An error occurred while flushing the output buffer due to insufficient space for the formatted key-value pair.
`MCO_E_LEWS_PARENT_IS_NOT_OBJECT`
The current parent context is not a JSON object (e.g., you are at the root level or inside an array).
Other error codes
May indicate internal errors (e.g., invalid arguments, null pointers).

### Files

Header file:
mcoewslite.h
Source file:
mcoewslite.c
Library:
mcoewslite.a