mco_lJSON_obj_add_int

Prototype

    MCO_RET mco_lJSON_obj_add_int(lews_JSON_context_h json_ctx, const char *key, int 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
Integer value to be assigned to the field.

Description

This function adds a numeric key-value pair to the current JSON object (e.g., "x": 10).

The integer 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, "position");
    if (ret == MCO_S_OK) {
        ret = mco_lJSON_obj_add_int(&json_ctx, "x", 10);
        if (ret != MCO_S_OK) {
            printf("mco_lJSON_obj_add_int error %d\n", ret);
        }
        ret = mco_lJSON_obj_add_int(&json_ctx, "y", -17);
        if (ret != MCO_S_OK) {
            printf("mco_lJSON_obj_add_int 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
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