类 ara::diag::DiagnosticSovdRecordContentElementDataView

使用

同步函数 [SWS_DM_02288] 将一个带符号整数值（std::int64_t）插入到 SOVD 数据结构中指定的键 key（ara::core::StringView）下。它被声明为类 ara::diag::DiagnosticSovdRecordContentElementDataView 的方法，并通过头文件 ara/diag/diagnostic_sovd_content_element_data.h 包含。

前提条件与错误处理

根据 [SWS_DM_02288]，底层的 DiagnosticSovdContentElementData 对象必须属于类型 RecordContentElementData 或 ContentData，而要添加的元素本身不能是 ContentData。该函数被定义为 noexcept 并返回一个 ara::core::Result<void>。如果操作失败——例如因为目标容器具有不兼容的类型或无法添加该元素——则结果包含一个错误码；Interpretation：在键冲突的情况下通常也可能是这种情况。 问题 Q-524c832a794559b7 (未决)

并发性与交互

执行被指定为线程安全且异常安全 [SWS_DM_02288]。在该接口内部存在针对无符号整数（[SWS_DM_02289]）、浮点数（[SWS_DM_02290]）、布尔值（[SWS_DM_02291]）、字符串（[SWS_DM_02292]）以及嵌套数据元素（[SWS_DM_02293]）的同类型重载。相同的方法也在载体类 DiagnosticSovdContentElementData 上提供（[SWS_DM_02368]）。

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的同步成员函数 Add 用于在指定键下添加无符号 64 位整数值（[SWS_DM_02289]）。它用于 Diagnostic Management 的 SOVD 功能框架内，该功能提供符合 ASAM SOVD 的诊断通信（AUTOSAR_AP_SWS_Diagnostics §1.0 “Introduction and functional overview”、[SWS_DM_01369]）。

使用与调用

该方法通过头文件 ara/diag/diagnostic_sovd_content_element_data.h 引入。作为参数，它需要作为 ara::core::StringView 的标识符 key 以及作为 std::uint64_t 的待添加值 content_element（[SWS_DM_02289]）。该调用同步进行，被指定为 noexcept，并以 ara::core::Result<void> 的形式返回结果。

错误处理与边界条件

• 类型条件：实例化的 DiagnosticSovdContentElementData 必须为类型 RecordContentElementData 或 ContentData。此外，待添加的元素本身不得为类型 ContentData（[SWS_DM_02289]）。
• 错误行为：如果违反这些类型要求之一，或者无法添加该元素，则该函数返回错误的 ara::core::Result（[SWS_DM_02289]）。规范在此处未提及具体的错误码；推测该结果对象会提供诊断域的相应错误码。 问题 Q-ffca131eece93b35 (未决)
• 并发性：该函数被明确指定为 thread-safe 和 exception safe（[SWS_DM_02289]）。

相互作用

该方法属于用于获取基本和复杂数据元素的一系列类型化重载，其中包括用于有符号整数（[SWS_DM_02288]）和结构化子元素（[SWS_DM_02293]）的变体。类 DiagnosticSovdContentElementData 上并行提供了等效接口（[SWS_DM_02369]）。

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的同步成员函数 Add 向数据记录中指定键 key 下添加类型为 double 的原始浮点值 [SWS_DM_02290]。该函数用于为 Diagnostic Management 的 SOVD 服务器功能构建结构化诊断数据 [SWS_DM_01369]。

执行时适用以下类型相关的前提条件 [SWS_DM_02290]：

• 目标对象必须是类型 RecordContentElementData 或 ContentData。
• 要添加的元素本身不得为类型 ContentData。

该方法声明为 noexcept（异常安全，exception safe），并针对并发访问指定为线程安全（thread-safe）[SWS_DM_02290]。若添加失败——例如由于对象类型不兼容或无法插入该元素——则通过返回的 ara::core::Result<void> 报告错误 [SWS_DM_02290]。解读：具体的错误原因应当会反映在 Result 对象的 ara::core::ErrorCode 中。 问题 Q-c987f75d785d3e90 (未决)

与 Add 的相关重载结合使用，该方法允许使用整数值 ([SWS_DM_02288], [SWS_DM_02289])、布尔值 [SWS_DM_02291]、字符串 [SWS_DM_02292] 或更复杂的元素数据 [SWS_DM_02293] 结构化填充 SOVD 数据记录。

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的函数 Add 用于在指定键下向 SOVD 数据元素添加布尔原始值 [SWS_DM_02291]。通过头文件 ara/diag/diagnostic_sovd_content_element_data.h 进行调用，参数名称为类型 ara::core::StringView 的 key 以及类型 bool 的有效载荷值 content_element [SWS_DM_02291]。由于该方法立即返回 ara::core::Result<void> 且未指定异步性，因此该过程应当同步运行。 问题 Q-a16b08bf68f8590b (未决)

错误处理通过返回的 ara::core::Result<void> 进行。如果底层 DiagnosticSovdContentElementData 既不是类型 RecordContentElementData 也不是 ContentData，或者无法添加该元素，则会报告错误 [SWS_DM_02291]。规范摘录中未进一步详细列出具体的错误代码。

关于并发和执行安全性，该方法归类为 thread-safe 并提供异常安全（noexcept）[SWS_DM_02291]。作为结构性限制，规范要求要添加的元素本身不得为类型 ContentData [SWS_DM_02291]。

在整个系统中，该方法补充了针对有符号整数 [SWS_DM_02288]、无符号整数 [SWS_DM_02289]、浮点数 [SWS_DM_02290]、字符串 [SWS_DM_02292] 以及下级内容元素 [SWS_DM_02293] 的相关重载。此外，在 Diagnostic Management 的 SOVD 服务器功能上下文中，类 DiagnosticSovdContentElementData [SWS_DM_02371] 上也存在类似的接口 [SWS_DM_01369]。

使用

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的同步方法 Add 用于向 SOVD 数据元素添加具有键和原始字符串值的条目 [SWS_DM_02292]。通过两个参数 key 和 content_element 进行调用，二者分别作为 ara::core::StringView 传递 [SWS_DM_02292]。该函数提供 ara::core::Result<void> 作为返回值，以指示操作结果 [SWS_DM_02292]。

错误处理

如果添加失败，该方法在 ara::core::Result 中返回错误 [SWS_DM_02292]。当底层对象不是类型 RecordContentElementData 或 ContentData，或者无法添加该元素时，会发生这种情况 [SWS_DM_02292]。解读：具体的错误代码应当由实现的关联错误域决定，因为规范未在函数定义中显式枚举它们。 问题 Q-ba196615f0cd8fc8 (未决)

并发性与边界条件

该操作声明为线程安全 (thread-safe) 以及异常安全 (exception safe)，并标注为 noexcept [SWS_DM_02292]。作为基本前提条件，作为参数传递的元素本身不得为类型 ContentData [SWS_DM_02292]。

相互作用

该函数是 AUTOSAR Diagnostic Management (DM) 的组成部分，用于实现针对 Adaptive Platform 的 SOVD AUTOSAR_AP_SWS_Diagnostics §1 “Introduction and functional overview”，其中 DM 充当 SOVD 服务器 [SWS_DM_01369]。在同一范围内，存在用于有符号整数 [SWS_DM_02288]、无符号整数 [SWS_DM_02289]、浮点数 [SWS_DM_02290]、布尔值 [SWS_DM_02291] 以及复杂数据元素 [SWS_DM_02293] 的类似 Add 重载。此外，ara::diag::DiagnosticSovdContentElementData 提供了相应的字符串重载 [SWS_DM_02372]。

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的同步函数 Add 会在指定键 key 下向数据元素添加一个类型为 DiagnosticSovdContentElementData 的嵌套元素 [SWS_DM_02293]。这用于在 SOVD（Service-Oriented Vehicle Diagnostics）框架下结构化地提供诊断数据，SOVD 由 Adaptive Platform 上的 Diagnostic Management (DM) 提供支持（[SWS_DM_01369]、AUTOSAR_AP_SWS_Diagnostics §1 “Introduction and functional overview”）。

在使用时必须遵守强制性类型规定：

• 调用方数据对象必须属于类型 RecordContentElementData 或 ContentData [SWS_DM_02293]。
• 要添加的元素 content_element 明确不得属于类型 ContentData [SWS_DM_02293]。
• 除复杂数据结构外，针对基本值还提供有单独的重载，例如针对整数值（[SWS_DM_02288]，[SWS_DM_02289]）、浮点数 [SWS_DM_02290]、布尔值 [SWS_DM_02291] 或字符串 [SWS_DM_02292]，正如它们在 DiagnosticSovdContentElementData 上所定义的那样 [SWS_DM_02373]。

对于错误处理，该函数返回一个 ara::core::Result<void>。如果操作失败——例如由于违反类型前提条件或无法插入元素——则结果包含一个错误 [SWS_DM_02293]。确切的错误编码大概基于诊断管理的域特定错误。 问题 Q-56c929209d0c7358 (未决)关于并发性和安全性，该方法被声明为 noexcept，被视为异常安全（exception safe），并针对并发访问被指定为线程安全（thread-safe）[SWS_DM_02293]。

用法与语义

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的方法 Clear 用于从 RecordContentElementData [SWS_DM_02276] 中同步移除所有内容元素。该调用通过头文件 #include "ara/diag/diagnostic_sovd_content_element_data.h" 无参数进行，并且没有返回值（void）[SWS_DM_02276]。

作为执行的先决条件，规定底层数据实例必须为 RecordContentElementData 或 ContentData 类型 [SWS_DM_02276]。解释：由于该函数声明为 noexcept 且不报告错误状态，因此在创建视图对象时推测已预先确保了对该数据类型的符合性。 问题 Q-93e43eee235a8f12 (未决)

错误处理与并发

在执行安全性方面，该方法被指定为 exception safe，并且通过 noexcept 声明不引发任何异常 [SWS_DM_02276]。此外，该调用被明确归类为 thread-safe，因此允许并发访问 [SWS_DM_02276]。

相互协作与区分

在 SOVD 环境中，该函数与 DiagnosticSovdContentElementData [SWS_DM_02338] 上的方法 Clear 区分开来，后者针对数组元素定义并返回 ara::core::Result<void>。同样，它在功能上也区别于用于数组的视图方法 [SWS_DM_02233]，以及通过 ara::diag::DTCInformation::Clear 异步删除 DTC 的操作，后者返回 ara::core::Future<void> 且不是线程安全的 [SWS_DM_00671]。

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的成员函数 Erase 用于从诊断数据记录中移除子内容元素（[SWS_DM_02294]、AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.14 “Erase”）。该声明通过头文件 #include "ara/diag/diagnostic_sovd_content_element_data.h" 提供（[SWS_DM_02294]）。

用法与语义：该函数接收 DiagnosticSovdRecordContentElementDataIterator 类型的迭代器 iterator 作为输入参数，该迭代器指向具体要删除的元素（[SWS_DM_02294]）。解释：由于该函数声明为 noexcept 且直接返回 ara::core::Result<void> 而不是 Future 对象，因此删除过程推测是在调用者线程中同步执行的。 问题 Q-148ae95c28910b16 (未决)成功执行时，该方法返回一个空的 ara::core::Result<void>（[SWS_DM_02294]）。

错误处理：当相关数据元素既不属于 RecordContentElementData 类型也不属于 ContentData 类型，或者无法从容器中移除该元素时，操作失败（[SWS_DM_02294]）。在这些错误情况下，该函数返回一个带有错误码 DiagErrc::kInvalidArgument 的错误（[SWS_DM_02294]）。

并发与交互：对于调用而言，该接口被指定为 thread-safe 以及 exception safe（[SWS_DM_02294]）。从业务功能上看，该函数对应于数组变体 ara::diag::DiagnosticSovdArrayContentElementDataView::Erase（[SWS_DM_02247]、AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.8 “Erase”），并与容器类 DiagnosticSovdContentElementData 用于数组（[SWS_DM_02352]）和记录（[SWS_DM_02374]）的基本删除操作相互配合。

View 类 ara::diag::DiagnosticSovdRecordContentElementDataView 的同步成员函数 Find 用于根据其键查找元素（[SWS_DM_02285]，AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.15 “Find”）。作为参数，传入类型为 ara::core::StringView 的 key；作为结果，该函数返回类型为 DiagnosticSovdRecordContentElementDataIterator 的可修改迭代器（[SWS_DM_02285]）。使用的前提条件是关联的 DiagnosticSovdContentElementData 的类型为 RecordContentElementData 或 ContentData（[SWS_DM_02285]）。

关于错误处理和并发性，该函数被声明为 noexcept，被视为异常安全（exception safe），且根据规范是线程安全的（thread-safe）（[SWS_DM_02285]）。由于返回类型直接是迭代器而不是 ara::core::Result，该函数不报告特定的错误码；如果所查找的键不存在，推测可能返回尾后迭代器（end iterator）。 问题 Q-a34054c9851517ae (未决)

在与相关接口的交互中，同一 View 类上存在一个返回 DiagnosticSovdRecordContentElementDataConstIterator 的常量重载（[SWS_DM_02286]，AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.16 “Find”）。类 DiagnosticSovdRecordContentElementDataConstView 也提供了类似的常量接口（[SWS_DM_02306]，AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.7 “Find”）。相比之下，DiagnosticSovdContentElementData 上的方法 Find 将其迭代器封装在 ara::core::Result 中，以便将无效类型或缺失的键表示为错误（[SWS_DM_02365]，[SWS_DM_02366]，AUTOSAR_AP_SWS_Diagnostics §8.60.6.1.2.25 “Find”）。

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的同步成员函数 Find 用于根据数据元素的键以只读方式查找该元素（[SWS_DM_02286]、AUTOSAR AP SWS Diagnostics §8.60.11.1.1.16 “Find”）。

用法与参数

该函数接收所查找的键 key 作为 ara::core::StringView（[SWS_DM_02286]）。调用的先决条件是该实例属于诊断类型 RecordContentElementData 或 ContentData（[SWS_DM_02286]）。作为返回值，它同步提供一个 DiagnosticSovdRecordContentElementDataConstIterator 类型的常量迭代器（[SWS_DM_02286]）。如果不存在与该键匹配的元素，推测可能会返回一个标记序列末尾的迭代器（解释）。 问题 Q-41a1eba77c0bc236 (未决)

错误处理与并发

该接口声明为 noexcept，保证异常安全（exception safe），并被指定为适用于并发访问的线程安全（thread-safe）（[SWS_DM_02286]）。与 ara::diag::DiagnosticSovdContentElementData（[SWS_DM_02366]）上的方法不同，它不通过 ara::core::Result 返回，因此错误情况不会通过错误码来表示。

相互作用

对于针对同一视图的写入或修改性访问，存在带有可变迭代器的非常量重载 [SWS_DM_02285]。对于纯读取视图，类 DiagnosticSovdRecordContentElementDataConstView 提供了类似的 Find 函数（[SWS_DM_02306]）。

类ara::diag::DiagnosticSovdRecordContentElementDataView的同步成员函数Remove用于根据其键有针对性地移除一个条目[SWS_DM_02287]。它在头文件ara/diag/diagnostic_sovd_content_element_data.h中定义，并处理类型为ara::core::StringView的参数keyAUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.19 “Remove”。

作为返回值，该函数提供一个ara::core::Result<bool>[SWS_DM_02287]：

• 成功时，所包含的布尔值指示是否能够实际移除寻址的元素。
• 当元素不属于类型RecordContentElementData或ContentData，或者未找到指定的键时，会通过ara::core::Result报告错误[SWS_DM_02287]。

在并发性和限制方面，该函数被指定为异常安全（exception safe）和线程安全（thread-safe），并声明带有noexcept[SWS_DM_02287]。作为调用条件，规范强制要求基础实例的类型为RecordContentElementData或ContentData[SWS_DM_02287]。

解释：从功能上讲，该操作可能对应于数据类ara::diag::DiagnosticSovdContentElementData::Remove上的移除[SWS_DM_02367]，因为签名、参数和错误场景被指定为完全一致AUTOSAR_AP_SWS_Diagnostics §8.60.6.1.2.54 “Remove”。 问题 Q-5a9ac29a9b5814be (未决)

类 ara::diag::DiagnosticSovdRecordContentElementDataView 的方法 Reserve（[SWS_DM_02283]、AUTOSAR_AP_SWS_Diagnostics §8.60.11.1.1.20 “Reserve”）同步预留所需的 RecordContentElementData 存储容量。该调用通过头文件 #include "ara/diag/diagnostic_sovd_content_element_data.h" 提供，并接受类型为 std::size_t 的参数 capacity。该函数提供 void 作为返回值。

该接口被声明为 noexcept 并被指定为异常安全（“exception safe”）（[SWS_DM_02283]）。既不返回特定的错误码，也不返回错误结构。解释：如果所需容量的分配失败，由于缺少如 ara::core::Result 这样的返回通道，该错误想必会在内部被拦截或导致程序中止。 问题 Q-ddbaac36f8ed58ad (未决)

关于并发性，该函数被定义为线程安全（“thread-safe”）（[SWS_DM_02283]）。因此，它可以从多个线程并行调用，无需额外的同步措施。

在与相关接口的协同中，数组变体 DiagnosticSovdArrayContentElementDataView::Reserve ([SWS_DM_02240]) 的行为类似。与此不同，DiagnosticSovdContentElementData::Reserve ([SWS_DM_02345]) 返回一个 ara::core::Result<void> 以报告类型冲突。相比之下，函数 DiagnosticServiceDynamicAccessList::Reserve ([SWS_DM_01163]) 用于服务模式的最坏情况预先分配，需要两个参数，且不是线程安全的。