类 ara::diag::DiagnosticSovdArrayContentElementDataView

使用

类 ara::diag::DiagnosticSovdArrayContentElementDataView 的成员函数 Clear 清空 SOVD 数组元素（[SWS_DM_02233]）的全部内容。该调用通过头文件 #include "ara/diag/diagnostic_sovd_content_element_data.h" 提供。该方法的签名形式为 auto Clear () noexcept -> void;。它同步工作，不接受任何参数，并且不提供返回值（[SWS_DM_02233]）。

错误处理与边界条件

根据规范，该函数被定义为异常安全（exception safe）并带有说明符 noexcept（[SWS_DM_02233]）。它既不返回错误码，也不返回 ara::core::Result。作为约束性要求，被引用的 DiagnosticSovdContentElementData 必须为类型 ArrayContentElementData（[SWS_DM_02233]）。由于不发出任何错误信号，视图类在构造时想必就已确保符合此类型。 问题 Q-cdb2385e081c3456 (未决)

并发性

规范明确将该方法归类为线程安全（thread-safe）（[SWS_DM_02233]）。因此，可以无需外部同步从多个线程并发调用 Clear。

诊断子系统中的交互

在 SOVD 数据结构内部，该操作与其他清除方法密切相关：

• DiagnosticSovdContentElementData::Clear ([SWS_DM_02338]) 构成了元素级别的通用对应项，但返回一个 ara::core::Result<void>，且在该对象不表示数组时失败。
• DiagnosticSovdRecordContentElementDataView::Clear ([SWS_DM_02276]) 对类型为 RecordContentElementData 或 ContentData 的数据结构执行类似的清理。
• 与此相对，在经典故障存储器上下文中，ara::diag::DTCInformation::Clear ([SWS_DM_00671]) 用于通过 ara::core::Future 异步清理 UDS DTC。

使用

类 ara::diag::DiagnosticSovdArrayContentElementDataView 的方法 Erase 用于从诊断 SOVD 内容数据中移除元素（[SWS_DM_02247]、SWS Diagnostics §8.60.5.1.1.8 “Erase”）。该函数接收一个 DiagnosticSovdArrayContentElementDataIterator 类型的迭代器作为参数，该迭代器指向要删除的元素。该调用作为同步操作执行；这推测源于其直接返回 ara::core::Result<void> 而未采用异步 Future 模式。 问题 Q-28de22574e525c78 (未决)

错误处理与边界条件

该函数声明为 noexcept，并具有 exception safe 以及 thread-safe 的属性（[SWS_DM_02247]）。如果删除失败，该方法会通过返回的 ara::core::Result 提供一个错误。当上级 DiagnosticSovdContentElementData 不属于所需类型 ArrayContentElementData 或因其他原因无法移除该元素时，就会出现这种情况（[SWS_DM_02247]）。

相互作用

在 SOVD 接口内部，该操作对应于底层数据容器 DiagnosticSovdContentElementData 用于数组元素的删除方法 Erase（[SWS_DM_02352]）。对于记录结构，存在 DiagnosticSovdRecordContentElementDataView::Erase 以及相应容器方法等类似的对等项（[SWS_DM_02294]、[SWS_DM_02374]）。

同步成员函数 PushBack 用于向诊断 SOVD 内容元素的数组结构追加类型为 std::int64_t 的带符号整数元素（[SWS_DM_02241]，AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.14 “PushBack”）。它在头文件 ara/diag/diagnostic_sovd_content_element_data.h 中声明，并定义为 noexcept（[SWS_DM_02241]）。

对于成功的调用，适用以下先决条件和接口要求：

• 调用上下文和前置条件：类 ara::diag::DiagnosticSovdArrayContentElementDataView 的目标对象必须代表一个 ArrayContentElementData，且要添加的原语类型必须与构造函数中定义的元素类型匹配（[SWS_DM_02241]）。
• 返回值和错误处理：该函数返回一个 ara::core::Result<void>。如果由于底层元素不是类型 ArrayContentElementData 而导致检查失败，则结果包含错误（[SWS_DM_02241]）。Interpretation：与构造函数中指定的数据类型不符的情况可能同样会作为结果对象中的错误被报告。 问题 Q-d4715ecbd0f12d26 (未决)
• 并发性：该函数被指定为 thread-safe 以及 exception-safe（[SWS_DM_02241]）。

该方法是 DiagnosticSovdArrayContentElementDataView 内部针对无符号整数（[SWS_DM_02242]）、浮点数（[SWS_DM_02243]）、布尔值（[SWS_DM_02244]）、字符串（[SWS_DM_02245]）以及完整数据元素（[SWS_DM_02246]）的类型化重载族的一部分。在数据类 DiagnosticSovdContentElementData 本身上也存在对应的方法（[SWS_DM_02346]）。

使用

类 ara::diag::DiagnosticSovdArrayContentElementDataView 的同步 API 函数 PushBack 将无符号 64 位整数值（std::uint64_t）作为原语数据元素追加到现有 SOVD 数组元素的末尾 [SWS_DM_02242]。通过头文件 ara/diag/diagnostic_sovd_content_element_data.h 包含 SWS Diagnostics §8.60.5.1.1.15 “PushBack”。成功调用的先决条件是当前元素代表一个 ArrayContentElementData，且要添加的值与构造函数中定义的元素类型匹配 [SWS_DM_02242]。

错误处理与并发

该函数通过 ara::core::Result<void> 指示其执行状态 [SWS_DM_02242]。如果目标对象不是类型 ArrayContentElementData，则该函数在结果中返回错误 [SWS_DM_02242]。由于未提及具体错误码（Interpretation：错误状态由 Result 通用指示），调用方必须求值 Result 对象。 问题 Q-95f2dd96e2681368 (未决)该方法被声明为 noexcept，保证异常安全性，并被明确指定为线程安全 [SWS_DM_02242]。

相互作用

该操作属于 DiagnosticSovdArrayContentElementDataView 内特定类型重载族，该族类似地通过 std::int64_t [SWS_DM_02241] 处理带符号整数、通过 double [SWS_DM_02243] 处理浮点数、通过 bool [SWS_DM_02244] 处理布尔值、通过 ara::core::StringView [SWS_DM_02245] 处理字符串，或处理类型为 DiagnosticSovdContentElementData [SWS_DM_02246] 的结构化元素。DiagnosticSovdContentElementData 也为 std::uint64_t 提供了同类实现 [SWS_DM_02347]。

使用

同步方法 PushBack 通过头文件 #include "ara/diag/diagnostic_sovd_content_element_data.h" 在类 ara::diag::DiagnosticSovdArrayContentElementDataView 的作用域内提供（[SWS_DM_02243]，AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.13 “PushBack”）。它将类型为 double 的原语浮点值作为内容元素追加到现有数组中（[SWS_DM_02243]）。唯一的传入参数是要添加的数据 content_element。

错误处理与边界条件

该函数返回一个 ara::core::Result<void>（[SWS_DM_02243]）。成功执行的前提是当前元素属于类型 ArrayContentElementData，且要添加的元素与 ArrayContentElementData 的构造函数中确定的类型相匹配（[SWS_DM_02243]）。如果目标不属于类型 ArrayContentElementData，则操作失败并在 Result 中返回错误（[SWS_DM_02243]）。

并发性

该函数被声明为 noexcept，确保异常安全性（exception safe），且根据规范是 thread-safe 的（[SWS_DM_02243]）。因此，多个线程可以并发调用该函数而无需外部同步。

相互作用

在 DiagnosticSovdArrayContentElementDataView 内部存在针对其他原语数据类型的同类型重载，其中包括 std::int64_t（[SWS_DM_02241]）、std::uint64_t（[SWS_DM_02242]）、bool（[SWS_DM_02244]）、ara::core::StringView（[SWS_DM_02245]）以及针对完整的 DiagnosticSovdContentElementData 对象（[SWS_DM_02246]）。在 DiagnosticSovdContentElementData 上也提供有类似的方法（例如 [SWS_DM_02348]）。

成员函数 PushBack 用于将带有原语数据类型 bool 的 DiagnosticSovdContentElementData 追加到现有数组元素中（[SWS_DM_02244]）。该接口在头文件 ara/diag/diagnostic_sovd_content_element_data.h 内的类 ara::diag::DiagnosticSovdArrayContentElementDataView 中定义（AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.12 “PushBack”）。作为输入参数，该同步函数接收布尔值 content_element（[SWS_DM_02244]）。

调用的先决条件是当前元素属于类型 ArrayContentElementData，且要添加的值与在数据结构构造函数中声明的类型一致（[SWS_DM_02244]）。如果目标元素不属于类型 ArrayContentElementData，则操作失败并返回带有相应错误的 ara::core::Result<void>；成功时结果包含一个空的 void（[SWS_DM_02244]）。

关于执行安全性，该方法被声明为 noexcept，并被指定为线程安全（thread-safe）和异常安全（exception safe）（[SWS_DM_02244]）。

该方法是 DiagnosticSovdArrayContentElementDataView 内部类型化 PushBack 重载族的一部分。除布尔值外，兄弟函数还涵盖整型类型如 std::int64_t（[SWS_DM_02241]）和 std::uint64_t（[SWS_DM_02242]）、浮点值 double（[SWS_DM_02243]）、字符串 ara::core::StringView（[SWS_DM_02245]）以及复合数据元素（[SWS_DM_02246]）的插入。在 DiagnosticSovdContentElementData 层级上也提供有对应的操作，其中包括布尔变体 [SWS_DM_02349]。

使用

类 ara::diag::DiagnosticSovdArrayContentElementDataView 的同步成员函数 PushBack（[SWS_DM_02245]，定义在 SWS Diagnostics §8.60.5.1.1.11 “PushBack” 中）向诊断 SOVD 数组追加一个具有基本类型字符串的新元素。为此必须包含头文件 ara/diag/diagnostic_sovd_content_element_data.h。该函数通过类型为 ara::core::StringView 的参数 content_element 接收要添加的元素。

错误处理

ara::core::Result<void> 作为返回类型。如果当前对象不是类型 ArrayContentElementData，或者传入元素的类型与 ArrayContentElementData 的构造函数中指定的元素类型不匹配（[SWS_DM_02245]），则在结果对象中返回错误。

并发性与限制

该函数使用说明符 noexcept 声明。它提供有保证的异常安全性（exception safe），并被指定为完全线程安全（thread-safe）（[SWS_DM_02245]）。

相互作用

该操作属于一组重载方法。在 DiagnosticSovdArrayContentElementDataView 内部，还存在针对标量类型如 std::int64_t（[SWS_DM_02241]）、std::uint64_t（[SWS_DM_02242]）、double（[SWS_DM_02243]）和 bool（[SWS_DM_02244]）以及针对类型为 DiagnosticSovdContentElementData 的完整元素（[SWS_DM_02246]）的其他重载。此外，类 ara::diag::DiagnosticSovdContentElementData 也提供了用于字符串的相应 PushBack 接口（[SWS_DM_02350]）。

使用

类 ara::diag::DiagnosticSovdArrayContentElementDataView（SWS Diagnostics §8.60.5.1.1.10 “PushBack”）的同步成员函数 PushBack 将类型为 DiagnosticSovdContentElementData 的元素追加到现有数组数据视图中（[SWS_DM_02246]）。作为传入参数，它按值接收要添加的对象 content_element，且没有返回值（void）。该声明通过头文件 ara/diag/diagnostic_sovd_content_element_data.h 提供。

并发性与前置条件

规范将该函数定义为异常安全（exception safe）、线程安全（thread-safe）并带有 noexcept 注解（[SWS_DM_02246]）。作为强制性前置条件，该操作要求当前元素属于类型 ArrayContentElementData，且要追加的元素与 ArrayContentElementData 构造函数中确定的类型完全一致（[SWS_DM_02246]）。

错误处理与交互

与返回 ara::core::Result<void> 以进行错误传递的原语类型重载（如 std::int64_t（[SWS_DM_02241]）、std::uint64_t（[SWS_DM_02242]）、double（[SWS_DM_02243]）、bool（[SWS_DM_02244]）或 ara::core::StringView（[SWS_DM_02245]））不同，该方法返回 void。因此，预先检查类型兼容性可能属于调用方的责任，因为此接口上的运行时错误不通过 Result 类型来指示。 问题 Q-00739dff7d34e242 (未决)在 DiagnosticSovdContentElementData 上也定义了用于追加数据元素的等效方法（[SWS_DM_02351]）。

类 ara::diag::DiagnosticSovdArrayContentElementDataView 的同步方法 Reserve 用于为数组数据元素预先分配存储容量（[SWS_DM_02240]、SWS Diagnostics §8.60.5.1.1.16 “Reserve”）。它通过头文件 #include "ara/diag/diagnostic_sovd_content_element_data.h" 提供，并接受类型为 std::size_t 的参数 capacity，该参数确定了底层 DiagnosticSovdArrayContentElementData 要提供的容量（[SWS_DM_02240]）。不返回任何返回值（[SWS_DM_02240]）。

在错误处理方面，该函数声明为异常安全（exception safe）以及 noexcept（[SWS_DM_02240]）。它既不通过 ara::core::Result 使用错误码，也不使用 C++ 异常。解释：在内存不足的情况下，由于调用方没有可用的错误通道，分配想必会在内部失败或导致程序中止。 问题 Q-348805197c004eea (未决)

对于并发性，该操作被显式指定为线程安全（thread-safe）（[SWS_DM_02240]）。因此，可以无需外部锁定从并行线程进行调用。

在整个系统中，该接口补充了相关的预留功能：虽然 DiagnosticSovdRecordContentElementDataView::Reserve 同样负责记录数据结构（[SWS_DM_02283]、SWS Diagnostics §8.60.11.1.1.20 “Reserve”），但通用基类函数 DiagnosticSovdContentElementData::Reserve 会返回一个 ara::core::Result<void>，以便在元素类型错误时报告错误（[SWS_DM_02345]、SWS Diagnostics §8.60.6.1.2.55 “Reserve”）。与非线程安全的内存预留 DiagnosticServiceDynamicAccessList::Reserve（[SWS_DM_01163]、SWS Diagnostics §8.13.1.1.3.3 “Reserve”）不同，此视图方法直接且并发地作用于 SOVD 数组元素。