结构体 ara::log::Format

结构体 ara::log::Format 用作日志系统中的格式化提示，将格式说明符 fmt（[SWS_LOG_00225]）与精度规范 precision（[SWS_LOG_00226]）绑定在一起。实例应优先通过提供的辅助函数创建，其中对 precision 的求值根据格式类型在整数的最少位数与浮点数的小数位数之间进行区分。对于整数类型，精度为零会被视作一，而在 Fmt::kDefault 下该字段会被完全忽略。

更多 ›

上下文

数据结构 ara::log::Format 在 AUTOSAR Adaptive Platform 的日志框架中用作输出格式化值的格式化提示。为此，它捆绑了两个核心属性：枚举类型 Fmt 的格式说明 fmt（[SWS_LOG_00225]）以及作为 std::uint16_t 的相关精度 precision（[SWS_LOG_00226]）。交互伙伴包括日志模块的输出组件和格式化流，以及生成具有格式化文本输出的日志消息的应用程序逻辑。Interpretation：规范中提到的用于实例化的辅助函数可能直接位于模块 ara::log 中，以提供标准化格式化。 问题 Q-1c465e69c99359fa (未决)

生命周期

作为最终数据结构（struct Format final），ara::log::Format 没有内部状态机，也没有复杂的阶段转换。尽管属性被声明为公共变量（[SWS_LOG_00225]，[SWS_LOG_00226]），但规范明确要求不要手动创建实例，而是使用提供的辅助函数。实例通常是寿命短暂的值对象，通过复制或引用传递给日志流。Interpretation：由于该结构不包含内部同步，跨线程边界的复制和并发读取访问可能是线程安全的，而可变访问必须进行外部同步。 问题 Q-bd0f1147e9472c19 (未决)

使用路径

典型用法包括确定格式说明符 fmt（[SWS_LOG_00225]）并指定所需的精度 precision（[SWS_LOG_00226]）。对 precision 的求值取决于 fmt 中选择的类型：

• 整数类型：对于 Fmt::kDec、Fmt::kOct、Fmt::kHex 和 Fmt::kBin，precision 表示要输出的最少位数，类似于通过 std::printf("%.7d") 进行的格式化。
• 定点和指数表示的浮点类型：对于 Fmt::kDecFloat、Fmt::kEngFloat 和 Fmt::kHexFloat，precision 指定小数位数的精确数量。
• 自动浮点表示：在 Fmt::kAutoFloat 下，precision 根据 std::printf 中格式说明符 %g 的规则定义有效位数。
• 默认格式化：当 fmt 的值为 Fmt::kDefault 时，precision 中的指定会被忽略，并应用由实现决定的格式化。

活动图：依赖于 fmt 对 precision 求值的分支逻辑。来源：[SWS_LOG_00225]，[SWS_LOG_00226]

错误场景

该结构不定义错误码或异常；边界情况改为以容错且确定性的方式处理。对于整数格式标识符（Fmt::kDec、Fmt::kOct、Fmt::kHex、Fmt::kBin），值 precision = 0（[SWS_LOG_00226]）的求值在语义上等同于值 1，以防止空输出。如果 fmt 设置为 Fmt::kDefault（[SWS_LOG_00225]），则 precision 中设置的值不会导致错误状态，而是会被静默丢弃。