sapi_log_fields_t Struct Reference

Bounded builder for sapi_log_write_event()'s extra_fields (or info) argument: accumulates space-separated key=value pairs, each typed at the call site, so a caller adding a couple of variable values does not hand-roll a sapi_string_concat()/sapi_string_append_u32() chain every time (MISRA C:2012 Rule 17.1 rules out a printf-style variadic here). More...

#include <sapi_log.h>

Collaboration diagram for sapi_log_fields_t:

Data Fields
sapi_string_t	str
char	storage [SAPI_LOG_EVENT_LINE_MAX_LEN]

Detailed Description

Bounded builder for sapi_log_write_event()'s extra_fields (or info) argument: accumulates space-separated key=value pairs, each typed at the call site, so a caller adding a couple of variable values does not hand-roll a sapi_string_concat()/sapi_string_append_u32() chain every time (MISRA C:2012 Rule 17.1 rules out a printf-style variadic here).

All storage is inside the struct - no allocation. Over-long content is truncated, never rejected, matching sapi_log_write_event()'s own REQ-OAL-LOG-001 posture. Typical use:

sapi_log_fields_t f;
sapi_log_fields_reset(&f);
sapi_log_fields_add_u32(&f, "route", route_id);
sapi_log_fields_add_i32(&f, "d_lrbg", d_lrbg);
sapi_log_fields_add_str(&f, "result", "OK");
sapi_log_write_event_fields(SAPI_LOG_LEVEL_INFO, "WEST", cycle,
                            "A/WEST", "IL", "ROUTE", "route connected", &f);

Definition at line 231 of file sapi_log.h.

Field Documentation

str

sapi_string_t sapi_log_fields_t::str

Bound to storage by sapi_log_fields_reset().

Definition at line 233 of file sapi_log.h.

storage

char sapi_log_fields_t::storage[SAPI_LOG_EVENT_LINE_MAX_LEN]

Backing bytes - do not touch directly.

Definition at line 234 of file sapi_log.h.

---

The documentation for this struct was generated from the following file:

• include/safeapi/oal/log/sapi_log.h