JR_STR_KV

Documentation

API Reference

JR_STR_KV

Description

Read a string key-value pair if key matches.

Parameters

Name	Direction	Description
`si`	in,out	JSON stream iterator to read from.
`k`	in	Expected key name (C-string).
`str`	out	Destination `Str` to store the value.

Usage example (from documentation)

  JR_STR_KV(si, "username", user.name);

Success

str contains the value if key matched

Failure

No-op if key does not match

Usage example (Cross-references)

Usage examples (Cross-references)

In MisraDoc.c:45:

            JR_OBJ(json, {                                                                                                 \
                JR_OBJ_KV(json, "project", {                                                                               \
                    JR_STR_KV(json, "build_dir", p.build_dir);                                                             \
                    JR_ARR_KV(json, "test_directories", {                                                                  \
                        Str s = StrInit();                                                                                 \

In MisraEnum.c:62:

        i64 last_value = 0;
        JR_OBJ(json, {
            JR_STR_KV(json, "name", enum_name);
            JR_BOOL_KV(json, "to_from_str", to_from_str);

In MisraEnum.c:66:

    
            JR_OBJ_KV(json, "invalid_enum", {
                JR_STR_KV(json, "name", invalid_enum.name);
                JR_INT_KV(json, "value", invalid_enum.value);
                JR_INT_KV(json, "str", invalid_enum.value);

In MisraEnum.c:79:

    
                JR_OBJ(json, {
                    JR_STR_KV(json, "name", e.name);
                    JR_INT_KV(json, "value", e.value);
                    JR_STR_KV(json, "str", e.str);

In MisraEnum.c:81:

                    JR_STR_KV(json, "name", e.name);
                    JR_INT_KV(json, "value", e.value);
                    JR_STR_KV(json, "str", e.str);
                });

In Read.Simple.c:69:

    
        JR_OBJ(si, {
            JR_STR_KV(si, "name", name);
            JR_STR_KV(si, "city", city);
        });

In Read.Simple.c:70:

        JR_OBJ(si, {
            JR_STR_KV(si, "name", name);
            JR_STR_KV(si, "city", city);
        });

In Read.Simple.c:178:

        JR_OBJ(si, {
            JR_INT_KV(si, "id", person.id);
            JR_STR_KV(si, "name", person.name);
            JR_INT_KV(si, "age", person.age);
            JR_BOOL_KV(si, "is_active", person.is_active);

In Read.Simple.c:232:

            JR_BOOL_KV(si, "debug_mode", config.debug_mode);
            JR_INT_KV(si, "timeout", config.timeout);
            JR_STR_KV(si, "log_level", config.log_level);
        });

In Read.Simple.c:342:

        JR_OBJ(si, {
            JR_OBJ_KV(si, "user", {
                JR_STR_KV(si, "name", data.user.name);
                JR_STR_KV(si, "email", data.user.email);
            });

In Read.Simple.c:343:

            JR_OBJ_KV(si, "user", {
                JR_STR_KV(si, "name", data.user.name);
                JR_STR_KV(si, "email", data.user.email);
            });
            JR_BOOL_KV(si, "active", data.active);

In Read.Simple.c:394:

        JR_OBJ(si, {
            JR_INT_KV(si, "id", product.id);
            JR_STR_KV(si, "name", product.name);
            JR_FLT_KV(si, "price", product.price);
            JR_ARR_KV(si, "tags", {

In Read.Nested.c:144:

        JR_OBJ(si, {
            JR_INT_KV(si, "id", data.id);
            JR_STR_KV(si, "name", data.name);
            JR_BOOL_KV(si, "active", data.active);
            JR_FLT_KV(si, "score", data.score);

In Read.Nested.c:206:

                JR_INT_KV(si, "id", data.user.id);
                JR_OBJ_KV(si, "profile", {
                    JR_STR_KV(si, "name", data.user.profile.name);
                    JR_INT_KV(si, "age", data.user.profile.age);
                });

In Read.Nested.c:210:

                });
            });
            JR_STR_KV(si, "status", data.status);
        });

In Read.Nested.c:277:

                JR_OBJ_KV(si, "departments", {
                    JR_OBJ_KV(si, "engineering", {
                        JR_STR_KV(si, "head", data.company.departments.engineering.head);
                        JR_INT_KV(si, "count", data.company.departments.engineering.count);
                        JR_FLT_KV(si, "budget", data.company.departments.engineering.budget);

In Read.Nested.c:282:

                    });
                });
                JR_STR_KV(si, "name", data.company.name);
            });
        });

In Read.Nested.c:359:

                    JR_OBJ(si, {
                        JR_FLT_KV(si, "distance", sym.distance);
                        JR_STR_KV(si, "name", sym.function_name);
                    });

In Read.Nested.c:442:

        JR_OBJ(si, {
            JR_BOOL_KV(si, "status", response.status);
            JR_STR_KV(si, "message", response.message);
    
            if (response.status) {

In Read.Nested.c:461:

                            JR_INT_KV(si, "nearest_neighbor_analysis_id", sym.analysis_id);
                            JR_INT_KV(si, "nearest_neighbor_binary_id", sym.binary_id);
                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);

In Read.Nested.c:462:

                            JR_INT_KV(si, "nearest_neighbor_binary_id", sym.binary_id);
                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);

In Read.Nested.c:463:

                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);
                            JR_STR_KV(si, "nearest_neighbor_function_name_mangled", sym.function_mangled_name);

In Read.Nested.c:465:

                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);
                            JR_STR_KV(si, "nearest_neighbor_function_name_mangled", sym.function_mangled_name);
                        });

In Read.Nested.c:585:

        JR_OBJ(si, {
            JR_INT_KV(si, "id", info.id);
            JR_STR_KV(si, "name", info.name);
            JR_INT_KV(si, "size", info.size);
            JR_INT_KV(si, "vaddr", info.vaddr);

In Read.Nested.c:632:

        JR_OBJ(si, {
            JR_INT_KV(si, "id", info.id);
            JR_STR_KV(si, "name", info.name);
        });

In Read.Nested.c:675:

        JR_OBJ(si, {
            JR_INT_KV(si, "binary_id", result.binary_id);
            JR_STR_KV(si, "binary_name", result.binary_name);
            JR_INT_KV(si, "analysis_id", result.analysis_id);
            JR_STR_KV(si, "sha256", result.sha256);

In Read.Nested.c:677:

            JR_STR_KV(si, "binary_name", result.binary_name);
            JR_INT_KV(si, "analysis_id", result.analysis_id);
            JR_STR_KV(si, "sha256", result.sha256);
            JR_STR_KV(si, "created_at", result.created_at);
            JR_INT_KV(si, "model_id", result.model_id);

In Read.Nested.c:678:

            JR_INT_KV(si, "analysis_id", result.analysis_id);
            JR_STR_KV(si, "sha256", result.sha256);
            JR_STR_KV(si, "created_at", result.created_at);
            JR_INT_KV(si, "model_id", result.model_id);
            JR_STR_KV(si, "model_name", result.model_name);

In Read.Nested.c:680:

            JR_STR_KV(si, "created_at", result.created_at);
            JR_INT_KV(si, "model_id", result.model_id);
            JR_STR_KV(si, "model_name", result.model_name);
            JR_STR_KV(si, "owned_by", result.owned_by);
        });

In Read.Nested.c:681:

            JR_INT_KV(si, "model_id", result.model_id);
            JR_STR_KV(si, "model_name", result.model_name);
            JR_STR_KV(si, "owned_by", result.owned_by);
        });

In Read.Nested.c:760:

        JR_OBJ(si, {
            JR_BOOL_KV(si, "status", response.status);
            JR_STR_KV(si, "message", response.message);
    
            WriteFmt("[DEBUG] Parsed status: {}, message: '", response.status ? "true" : "false");

In Read.Nested.c:789:

                            JR_INT_KV(si, "nearest_neighbor_analysis_id", sym.analysis_id);
                            JR_INT_KV(si, "nearest_neighbor_binary_id", sym.binary_id);
                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);

In Read.Nested.c:790:

                            JR_INT_KV(si, "nearest_neighbor_binary_id", sym.binary_id);
                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);

In Read.Nested.c:791:

                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);
                            JR_STR_KV(si, "nearest_neighbor_function_name_mangled", sym.function_mangled_name);

In Read.Nested.c:793:

                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);
                            JR_STR_KV(si, "nearest_neighbor_function_name_mangled", sym.function_mangled_name);
                        });

In Read.Nested.c:929:

        JR_OBJ(si, {
            JR_BOOL_KV(si, "status", response.status);
            JR_STR_KV(si, "message", response.message);
    
            WriteFmt("[DEBUG] Parsed status: {}, message: '", response.status ? "true" : "false");

In Read.Nested.c:958:

                            JR_INT_KV(si, "nearest_neighbor_analysis_id", sym.analysis_id);
                            JR_INT_KV(si, "nearest_neighbor_binary_id", sym.binary_id);
                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);

In Read.Nested.c:959:

                            JR_INT_KV(si, "nearest_neighbor_binary_id", sym.binary_id);
                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);

In Read.Nested.c:960:

                            JR_STR_KV(si, "nearest_neighbor_analysis_name", sym.analysis_name);
                            JR_STR_KV(si, "nearest_neighbor_function_name", sym.function_name);
                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);
                            JR_STR_KV(si, "nearest_neighbor_function_name_mangled", sym.function_mangled_name);

In Read.Nested.c:962:

                            JR_STR_KV(si, "nearest_neighbor_sha_256_hash", sym.sha256);
                            JR_BOOL_KV(si, "nearest_neighbor_debug", sym.debug);
                            JR_STR_KV(si, "nearest_neighbor_function_name_mangled", sym.function_mangled_name);
                        });

In RoundTrip.c:122:

            JR_FLT_KV(si, "temperature", parsed.temperature);
            JR_BOOL_KV(si, "enabled", parsed.enabled);
            JR_STR_KV(si, "message", parsed.message);
        });

In RoundTrip.c:316:

        StrIter si = StrIterFromStr(json);
        JR_OBJ(si, {
            JR_STR_KV(si, "empty", parsed.empty);
            JR_STR_KV(si, "simple", parsed.simple);
            JR_STR_KV(si, "with_spaces", parsed.with_spaces);

In RoundTrip.c:317:

        JR_OBJ(si, {
            JR_STR_KV(si, "empty", parsed.empty);
            JR_STR_KV(si, "simple", parsed.simple);
            JR_STR_KV(si, "with_spaces", parsed.with_spaces);
            JR_STR_KV(si, "with_special", parsed.with_special);

In RoundTrip.c:318:

            JR_STR_KV(si, "empty", parsed.empty);
            JR_STR_KV(si, "simple", parsed.simple);
            JR_STR_KV(si, "with_spaces", parsed.with_spaces);
            JR_STR_KV(si, "with_special", parsed.with_special);
        });

In RoundTrip.c:319:

            JR_STR_KV(si, "simple", parsed.simple);
            JR_STR_KV(si, "with_spaces", parsed.with_spaces);
            JR_STR_KV(si, "with_special", parsed.with_special);
        });

In RoundTrip.c:476:

            JR_OBJ_KV(si, "user", {
                JR_INT_KV(si, "id", parsed_person.id);
                JR_STR_KV(si, "name", parsed_person.name);
                JR_INT_KV(si, "age", parsed_person.age);
                JR_BOOL_KV(si, "is_active", parsed_person.is_active);

In RoundTrip.c:572:

            JR_OBJ_KV(si, "user", {
                JR_INT_KV(si, "id", parsed.user.id);
                JR_STR_KV(si, "name", parsed.user.name);
                JR_INT_KV(si, "age", parsed.user.age);
                JR_BOOL_KV(si, "is_active", parsed.user.is_active);

In RoundTrip.c:580:

                JR_BOOL_KV(si, "debug_mode", parsed.config.debug_mode);
                JR_INT_KV(si, "timeout", parsed.config.timeout);
                JR_STR_KV(si, "log_level", parsed.config.log_level);
                JR_ARR_KV(si, "features", {
                    Str feature = StrInit();

In RoundTrip.c:675:

        StrIter si = StrIterFromStr(json);
        JR_OBJ(si, {
            JR_STR_KV(si, "empty_string", parsed_str);
            JR_ARR_KV(si, "empty_numbers", {
                i32 num = 0;

In Read.EdgeCases.c:162:

    
        JR_OBJ(si, {
            JR_STR_KV(si, "name", obj.name);
            JR_STR_KV(si, "description", obj.description);
        });

In Read.EdgeCases.c:163:

        JR_OBJ(si, {
            JR_STR_KV(si, "name", obj.name);
            JR_STR_KV(si, "description", obj.description);
        });

In Read.EdgeCases.c:330:

    
        JR_OBJ(si, {
            JR_STR_KV(si, "path", obj.path);
            JR_STR_KV(si, "message", obj.message);
            JR_STR_KV(si, "data", obj.data);

In Read.EdgeCases.c:331:

        JR_OBJ(si, {
            JR_STR_KV(si, "path", obj.path);
            JR_STR_KV(si, "message", obj.message);
            JR_STR_KV(si, "data", obj.data);
        });

In Read.EdgeCases.c:332:

            JR_STR_KV(si, "path", obj.path);
            JR_STR_KV(si, "message", obj.message);
            JR_STR_KV(si, "data", obj.data);
        });

In Read.EdgeCases.c:372:

    
        JR_OBJ(si, {
            JR_STR_KV(si, "escaped", obj.escaped);
            JR_STR_KV(si, "backslash", obj.backslash);
            JR_STR_KV(si, "newline", obj.newline);

In Read.EdgeCases.c:373:

        JR_OBJ(si, {
            JR_STR_KV(si, "escaped", obj.escaped);
            JR_STR_KV(si, "backslash", obj.backslash);
            JR_STR_KV(si, "newline", obj.newline);
            JR_STR_KV(si, "tab", obj.tab);

In Read.EdgeCases.c:374:

            JR_STR_KV(si, "escaped", obj.escaped);
            JR_STR_KV(si, "backslash", obj.backslash);
            JR_STR_KV(si, "newline", obj.newline);
            JR_STR_KV(si, "tab", obj.tab);
        });

In Read.EdgeCases.c:375:

            JR_STR_KV(si, "backslash", obj.backslash);
            JR_STR_KV(si, "newline", obj.newline);
            JR_STR_KV(si, "tab", obj.tab);
        });

In Read.EdgeCases.c:416:

    
        JR_OBJ(si, {
            JR_STR_KV(si, "name", obj.name);
            JR_INT_KV(si, "value", obj.value);
            JR_BOOL_KV(si, "flag", obj.flag);

Last updated on April 20, 2026

JR_STR JReadBool