JW_OBJ_KV

Documentation

API Reference

JW_OBJ_KV

Description

Write a key and nested object inside an existing JSON object. Should be called inside JW_OBJ. Adds commas appropriately based on insertion order.

Parameters

Name	Direction	Description
`j`	in,out	The target string to append to.
`k`	in	The key name to use in the JSON object.
`writer`	in	A block of code using `JW_*_KV` to populate the inner object.

Usage example (from documentation)

  JW_OBJ_KV(json, "config", {
      JW_INT_KV(json, "timeout", 30);
  });

Success

Appends a nested JSON object under the given key

Failure

Does not return on failure

Usage example (Cross-references)

Usage examples (Cross-references)

In Write.Nested.c:148:

    
        JW_OBJ(json, {
            JW_OBJ_KV(json, "user", {
                JW_INT_KV(json, "id", data.user.id);
                JW_OBJ_KV(json, "profile", {

In Write.Nested.c:150:

            JW_OBJ_KV(json, "user", {
                JW_INT_KV(json, "id", data.user.id);
                JW_OBJ_KV(json, "profile", {
                    JW_STR_KV(json, "name", data.user.profile.name);
                    JW_INT_KV(json, "age", data.user.profile.age);

In Write.Nested.c:192:

    
        JW_OBJ(json, {
            JW_OBJ_KV(json, "company", {
                JW_OBJ_KV(json, "departments", {
                    JW_OBJ_KV(json, "engineering", {

In Write.Nested.c:193:

        JW_OBJ(json, {
            JW_OBJ_KV(json, "company", {
                JW_OBJ_KV(json, "departments", {
                    JW_OBJ_KV(json, "engineering", {
                        JW_STR_KV(json, "head", data.company.departments.engineering.head);

In Write.Nested.c:194:

            JW_OBJ_KV(json, "company", {
                JW_OBJ_KV(json, "departments", {
                    JW_OBJ_KV(json, "engineering", {
                        JW_STR_KV(json, "head", data.company.departments.engineering.head);
                        JW_INT_KV(json, "count", data.company.departments.engineering.count);

In Write.Nested.c:243:

            JW_BOOL_KV(json, "status", response.status);
            JW_STR_KV(json, "message", response.message);
            JW_OBJ_KV(json, "data", {
                // Write dynamic key for source function ID
                Str source_key = StrInit();

In Write.Nested.c:249:

                StrWriteFmt(&source_key, "{}", source_id);
    
                JW_OBJ_KV(json, source_key.data, {
                    if (response.data.length > 0) {
                        AnnSymbol *s          = &VecAt(&response.data, 0);

In Write.Nested.c:255:

                        StrWriteFmt(&target_key, "{}", s->target_function_id);
    
                        JW_OBJ_KV(json, target_key.data, {
                            JW_FLT_KV(json, "distance", s->distance);
                            JW_INT_KV(json, "nearest_neighbor_analysis_id", s->analysis_id);

In Write.Nested.c:407:

    
        JW_OBJ(json, {
            JW_OBJ_KV(json, "functions", {
                VecForeach(&symbols, symbol) {
                    Str source_key = StrInit();

In Write.Nested.c:412:

                    StrWriteFmt(&source_key, "{}", symbol.source_function_id);
    
                    JW_OBJ_KV(json, source_key.data, {
                Str target_key = StrInit();
                StrWriteFmt(&target_key, "{}", symbol.target_function_id);

In Write.Nested.c:416:

                StrWriteFmt(&target_key, "{}", symbol.target_function_id);
    
                JW_OBJ_KV(json, target_key.data, {
                    JW_FLT_KV(json, "distance", symbol.distance);
                    JW_STR_KV(json, "name", symbol.function_name);

In Write.Nested.c:453:

    
        JW_OBJ(json, {
            JW_OBJ_KV(json, "level1", {
                JW_OBJ_KV(json, "level2", {
                    JW_OBJ_KV(json, "level3", {

In Write.Nested.c:454:

        JW_OBJ(json, {
            JW_OBJ_KV(json, "level1", {
                JW_OBJ_KV(json, "level2", {
                    JW_OBJ_KV(json, "level3", {
                        JW_STR_KV(json, "message", deep_message);

In Write.Nested.c:455:

            JW_OBJ_KV(json, "level1", {
                JW_OBJ_KV(json, "level2", {
                    JW_OBJ_KV(json, "level3", {
                        JW_STR_KV(json, "message", deep_message);
                        JW_INT_KV(json, "value", 42);

In Write.EdgeCases.c:313:

    
        JW_OBJ(json, {
            JW_OBJ_KV(
                json,
                "outer",

In Write.EdgeCases.c:321:

            );
            JW_ARR_KV(json, "list", empty_list, item, { JW_INT(json, item); });
            JW_OBJ_KV(json, "deep", {
                JW_OBJ_KV(
                    json,

In Write.EdgeCases.c:322:

            JW_ARR_KV(json, "list", empty_list, item, { JW_INT(json, item); });
            JW_OBJ_KV(json, "deep", {
                JW_OBJ_KV(
                    json,
                    "inner",

In Write.EdgeCases.c:358:

    
        JW_OBJ(json, {
            JW_OBJ_KV(
                json,
                "empty_obj",

In Write.EdgeCases.c:365:

                }
            );
            JW_OBJ_KV(json, "filled_obj", { JW_INT_KV(json, "x", x_value); });
            JW_ARR_KV(json, "empty_arr", empty_arr, item, { JW_INT(json, item); });
            JW_ARR_KV(json, "filled_arr", filled_arr, item, { JW_INT(json, item); });

In Write.Simple.c:278:

    
        JW_OBJ(json, {
            JW_OBJ_KV(json, "user", {
                JW_STR_KV(json, "name", data.user.name);
                JW_STR_KV(json, "email", data.user.email);

In RoundTrip.c:460:

        Str json = StrInit();
        JW_OBJ(json, {
            JW_OBJ_KV(json, "user", {
                JW_INT_KV(json, "id", original_person.id);
                JW_STR_KV(json, "name", original_person.name);

In RoundTrip.c:539:

        Str json = StrInit();
        JW_OBJ(json, {
            JW_OBJ_KV(json, "user", {
                JW_INT_KV(json, "id", original.user.id);
                JW_STR_KV(json, "name", original.user.name);

In RoundTrip.c:546:

                JW_FLT_KV(json, "salary", original.user.salary);
            });
            JW_OBJ_KV(json, "config", {
                JW_BOOL_KV(json, "debug_mode", original.config.debug_mode);
                JW_INT_KV(json, "timeout", original.config.timeout);

In RoundTrip.c:658:

            JW_ARR_KV(json, "empty_numbers", empty_numbers, num, { JW_INT(json, num); });
            JW_ARR_KV(json, "empty_strings", empty_strings, str, { JW_STR(json, str); });
            JW_OBJ_KV(
                json,
                "empty_object",

Last updated on April 20, 2026

JW_OBJ JW_STR