类 ara::log::Logger

类 ara::log::Logger 的成员函数 LogDebug 用于生成错误严重级别为 Debug 的日志消息，并为此返回相应配置的 LogStream 对象 [SWS_LOG_00068]。通过头文件 #include "ara/log/logger.h" 进行声明 [SWS_LOG_00068]。

关于用法和语义，定义了以下规范特性：

• 调用与返回值：该方法不接受传入参数，并直接返回具有 Debug 严重级别的 LogStream 对象 [SWS_LOG_00068]。其工作方式与方法 Logger::LogFatal() 相同 [SWS_LOG_00068]。
• 错误处理：该签名被声明为 noexcept，并被指定为异常安全（exception safe）[SWS_LOG_00068]。出错时不会生成任何错误消息或错误代码 [SWS_LOG_00068]。
• 并发性：该成员函数被分类为常量（const）并显式分类为线程安全（thread-safe）[SWS_LOG_00068]，因此允许通过同一 Logger 实例进行并发读取访问。

类 ara::log::Logger 的方法 LogError 用于发起严重级别为 Error 的日志条目 [SWS_LOG_00065]。该函数通过头文件 ara/log/logger.h 声明，且不接受任何参数 [SWS_LOG_00065]。

使用方法与返回值

同步调用返回一个严重级别为 Error 的类型为 LogStream 的对象 [SWS_LOG_00065]。该行为在功能上与 Logger::LogFatal() 的行为相对应 [SWS_LOG_00065]。由于 LogError 被声明为 const，因此调用不会修改记录器对象的状态，也可以在常量实例上执行 [SWS_LOG_00065]。

并发与异常安全性

以下保证适用于调用上下文 [SWS_LOG_00065]：

• 线程安全性：该函数被指定为 thread-safe [SWS_LOG_00065]。解释：因此，想必可以无需外部同步从多个线程在同一实例上并发执行调用。 问题 Q-e55d2b523c5cbcb3 (未决)
• 异常安全性：该方法被声明为 noexcept 以及 exception safe [SWS_LOG_00065]；它在运行时不会触发异常。

错误处理

对于 LogError，未规定具体的错误码或向 DET 或 DEM 发送的通知 [SWS_LOG_00065]。通过保证的异常安全性和无参数接口，排除了调用时的错误状态 [SWS_LOG_00065]。

用法与生命周期

类 ara::log::Logger 的方法 LogFatal（通过头文件 ara/log/logger.h 提供）创建一个严重级别为 Fatal 的 LogStream 对象（[SWS_LOG_00064]）。该函数不接收任何参数并直接返回该流。返回的 LogStream 对象通过流运算符 << 顺序接收日志消息和参数（[SWS_LOG_00064]）。在常规应用场景中，所创建流的生命周期仅限于单个语句，并在最后一个传递的参数后面的结尾分号处结束（[SWS_LOG_00064]）。为了进一步延长流对象的生命周期，可以将其分配给具名变量（[SWS_LOG_00064]）。

错误处理与并发

该函数声明为 noexcept，并被指定为异常安全（exception safe）（[SWS_LOG_00064]）。它在运行时不抛出任何异常，也不使用特定的错误码。在并发方面，该方法被指定为 const 以及完全线程安全（thread-safe），从而允许通过同一 Logger 实例进行并行调用（[SWS_LOG_00064]）。

相互作用

该方法在接口和行为上与 ara::log::Logger 内部针对不同严重级别的相关日志记录方法一致：LogError（[SWS_LOG_00065]）、LogWarn（[SWS_LOG_00066]）、LogInfo（[SWS_LOG_00067]）、LogDebug（[SWS_LOG_00068]）以及 LogVerbose（[SWS_LOG_00069]）。

类 ara::log::Logger 的成员函数 LogInfo（[SWS_LOG_00067]）通过头文件 ara/log/logger.h 声明。它用于创建严重级别为 Info 的日志消息，不需要传入参数，并同步返回一个类型为 LogStream 的对象（[SWS_LOG_00067]）。根据规范，其行为与 Logger::LogFatal()（[SWS_LOG_00067]）的行为相对应，其解释是其功能以类似方式工作，仅将严重级别分类固定为 Info。

关于并发性和调用上下文，该方法被声明为 const 并显式指定为线程安全（thread-safe）（[SWS_LOG_00067]）。因此，可以随时由多个线程在同一 Logger 实例上并行调用 LogInfo，而无需应用程序负责的同步机制或锁。

在错误处理方面，该函数带有标识符 noexcept 并被归类为异常安全（exception safe）（[SWS_LOG_00067]）。既不返回特定的错误码，也不触发 DEM 或 DET 错误消息（[SWS_LOG_00067]）；未为此调用定义错误情况。

在需求架构中，该接口直接分配给上游需求 [RS_LT_00003] 和 [RS_LT_00049]（[SWS_LOG_00067]），这些需求定义了日志记录与跟踪子系统的上层指导方针。

来自头文件 #include "ara/log/logger.h" 的类 ara::log::Logger 的方法 LogVerbose() 用于生成具有最详细严重级别 Verbose 的日志输出 [SWS_LOG_00069]。调用时不传递任何参数。该函数同步返回一个 LogStream 对象，该对象显式使用严重级别 Verbose 初始化，并用于传递消息内容 [SWS_LOG_00069]。

该规范指出其行为与 Logger::LogFatal() 相同 [SWS_LOG_00069]；作为解释，这可能意味着流的缓冲和提供遵循常规日志机制，仅分配的严重级别有所不同。 问题 Q-522523e7a845dc3a (未决)关于错误处理，该方法被指定为 noexcept 以及 exception safe [SWS_LOG_00069]。因此不会引发任何异常，且调用上下文中不存在特定的错误代码 [SWS_LOG_00069]。

关于并发性和接口契约，适用以下属性：

• 线程安全性：该方法被分类为 thread-safe，因此可以通过相同或不同的 Logger 实例安全地执行并发调用 [SWS_LOG_00069]。
• 常量性：声明为 const 保证了该调用不会更改 Logger 对象的内部状态 [SWS_LOG_00069]。

使用

类 ara::log::Logger 的成员函数 LogWarn 通过头文件 ara/log/logger.h 提供 [SWS_LOG_00066]。该调用在 Logger 实例上无参数进行，签名形式为 LogStream LogWarn () const noexcept; [SWS_LOG_00066]。作为返回值，该函数同步返回一个严重级别分类为 Warn（Warn severity）的类型为 LogStream 的对象 [SWS_LOG_00066]。其功能行为与 Logger::LogFatal() 的描述相对应 [SWS_LOG_00066]。解释：提供的 LogStream 对象想必用于组装警告级别的日志消息以供进一步输出。 问题 Q-02b18df759926020 (未决)

并发性与错误安全性

关于调用上下文和并发性，该方法被指定为 thread-safe [SWS_LOG_00066]。因此，它可以从同一实例上的多个并发线程安全地调用。该函数保证完全的异常安全性（exception safe），并使用 noexcept 进行声明 [SWS_LOG_00066]。未为此操作定义特定的错误码、错误值或针对运行时错误的反馈信号 [SWS_LOG_00066]；解释：在常规运行中，想必可以排除返回失败的情况。 问题 Q-44b264cd97ff8159 (未决)

使用

类ara::log::Logger的模板方法LogWith用于根据标识符以及关联的属性和参数结构化地记录消息[SWS_LOG_00133]。它通过头文件#include "ara/log/logger.h"包含，并以同步方式执行且无返回值[SWS_LOG_00133]。

该函数接受以下参数[SWS_LOG_00133]：

• attrs：包含消息属性的std::tuple（类型Attrs...），
• msgId：类型为MsgId的实现定义实例，用于标识消息对象，
• params：添加到日志条目中的可变参数（类型Params...）。

并发性与限制

该函数被指定为thread-safe，并可以并发执行[SWS_LOG_00133]。它声明带有noexcept，并归类为异常安全（exception safe），因此不会抛出 C++ 异常[SWS_LOG_00133]。未定义特定错误代码或错误消息。

对于模板实例化，规则如下：如果Attrs...中至少有一个类型不是允许的消息属性，则该函数不参与重载解析[SWS_LOG_00133]。解释：由于规范中对类型Attr的要求标记为 TBD，具体类型检查可能取决于具体的平台实现。 问题 Q-30f5de483410d716 (未决)