类 ara::per::KeyValueStorage

[SWS_PER_00339] Upstream: RS_PER_00002, RS_AP_00122, RS_AP_00140, RS_AP_00146

class KeyValueStorage final {...};

The Key-Value Storage contains a set of keys with associated values.

Header-Datei	#include "ara/per/key_value_storage.h"
Forwarding-Header	#include "ara/per/per_fwd.h"
Scope	namespace ara::per

用户指南人工智能生成

通过具有显式同步的事务性读写操作管理持久性键值对。

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 74f93d55aa8a 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

通过具有显式同步的事务性读写操作管理持久性键值对。

该类提供了一个事务性工作的键值存储，其修改仅在通过 SyncToStorage() 写入物理数据介质或通过 DiscardPendingChanges() 丢弃时生效 [SWS_PER_00049]、[SWS_PER_00365]。实例既不可复制也不可移动，并提供线程安全的访问方法，但在销毁时需要排除并发调用 [SWS_PER_00322]、[SWS_PER_00050]。如果在同步期间发生硬件故障，则不再适用自动回滚语义 [SWS_PER_00049]。

上下文

类 ara::per::KeyValueStorage 在 AUTOSAR Adaptive Platform 内提供了一个类型化的键值存储，该存储将持久性数据作为带有分配值的键集合进行管理。它作为应用程序的主接口，用于持久存储和检索已配置的应用程序数据。访问以事务语义通过内部事务状态进行，而不是直接在物理存储介质上进行，正如 [SWS_PER_00042]、[SWS_PER_00043]、[SWS_PER_00044]、[SWS_PER_00332] 和 [SWS_PER_00554] 中对读取操作所指定的那样。修改操作最初仅产生事务性影响，并且仅在显式同步时才会更改物理存储 [SWS_PER_00046]、[SWS_PER_00047]、[SWS_PER_00048]、[SWS_PER_00049]。

生命周期

ara::per::KeyValueStorage 的实例化和所有权受到严格限制：默认构造函数 [SWS_PER_00459] 以及复制和移动构造函数 [SWS_PER_00324]、[SWS_PER_00322] 均被删除（=delete）。同样，复制和移动赋值运算符也被显式移除 [SWS_PER_00325]、[SWS_PER_00323]。因此，实例既不能被复制也不能被移动。存储对象的创建通过 OpenKeyValueStorage() 的初始化进行，这也定义了待处理更改的起点 [SWS_PER_00365]。析构函数 [SWS_PER_00050] 被指定为异常安全，但显式指定为非线程安全；因此，只有在不再有并行访问运行时才允许进行销毁。在常规运行中，所有访问方法均设计为线程安全，但在其他线程同时进行写入或同步调用时可能会发生延迟 [SWS_PER_00046]、[SWS_PER_00049]、[SWS_PER_00365]。

使用路径

典型使用路径包括设置或更新数据值、可选检查或读取当前事务状态，以及最后持久写入或放弃更改。使用 SetValue<T>() 在当前事务上下文中分配或覆盖键值对 [SWS_PER_00046]。可以通过 KeyExists() 检查现有键 [SWS_PER_00043]，通过 GetCurrentValueSize() 确定其字节大小 [SWS_PER_00554]，并通过 GetValue<T>() 的类型安全重载读取其值 [SWS_PER_00044]、[SWS_PER_00332]。只有调用 SyncToStorage() 才会将所有累计的更改以原子方式传输到物理存储介质 [SWS_PER_00049]。反之，若要放弃未同步的更改，DiscardPendingChanges() 会将状态重置为最后一次 SyncToStorage() 或打开时的状态 [SWS_PER_00365]。

时序图：修改、检查以及与物理存储同步的典型流程。来源：[SWS_PER_00046]、[SWS_PER_00332]、[SWS_PER_00049]、[SWS_PER_00365]

错误场景

所有方法均通过 ara::core::Result 返回错误。在此精确区分了具有回滚保证的操作与无回滚的错误：

配置与写保护错误：在只读存储上调用写入方法时，或者在仅写一次（Write-Only-Once）配置中键已存在时，操作因 PerErrc::kIllegalWriteAccess 失败 [SWS_PER_00046]、[SWS_PER_00047]、[SWS_PER_00048]、[SWS_PER_00049]。
类型冲突与键可用性：如果在覆盖或读取时数据类型与存储类型不一致，则发生 PerErrc::kDataTypeMismatch [SWS_PER_00044]、[SWS_PER_00332]、[SWS_PER_00046]。未找到键时报告 PerErrc::kKeyNotFound [SWS_PER_00044]、[SWS_PER_00554]。对于 ResetKey()，如果未定义初始值，则会触发 PerErrc::kInitValueNotAvailable [SWS_PER_00426]。
存储空间与配额违规：如果新数据量超出配置的限制 maximumAllowedSize，则报告 PerErrc::kQuotaExceeded [SWS_PER_00046]、[SWS_PER_00049]。如果物理存储不足，SyncToStorage() 或 RecoverKey() 会返回错误 PerErrc::kOutOfStorageSpace，且不具备回滚语义 [SWS_PER_00049]、[SWS_PER_00427]。
完整性、加密与硬件错误：物理访问错误（PerErrc::kPhysicalStorageFailure）在读取过程和 SetValue() 中具有回滚语义 [SWS_PER_00046]，而在 SyncToStorage() 中则没有回滚语义 [SWS_PER_00049]。结构损坏（PerErrc::kIntegrityCorrupted）、解密错误（PerErrc::kEncryptionFailed）或失败的 MAC 检查（PerErrc::kAuthenticationFailed）由读取、写入和恢复操作（例如 RecoverKey()）指示 [SWS_PER_00427]。

本指南由基于 AUTOSAR R25-11 的 AI 支持文档系统生成。

成员图

类图

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

详细视图

请在大纲中选择一个条目。

此版本没有元素数据

构造函数和析构函数

KeyValueStorage 函数 3

The move constructor for KeyValueStorage shall not be used.

重载 KeyValueStorage 3

KeyValueStorage (KeyValueStorage &&kvs)=delete; SWS_PER_00322

KeyValueStorage (const KeyValueStorage &)=delete; SWS_PER_00324

KeyValueStorage ()=delete; SWS_PER_00459

~KeyValueStorage 函数

Destructor for KeyValueStorage.

~KeyValueStorage () noexcept;

方法

DiscardPendingChanges 函数

Removes all pending changes to this Key-Value Storage since the last call to SyncToStorage() or since this Key-Value Storage was opened using OpenKeyValueStorage(). DiscardPendingChanges may be delayed by an ongoing call from another thread to RemoveAll Keys, SyncToStorage, DiscardPendingChanges, SetValue, GetValue, GetCurrentValueSize, RemoveKey, RecoverKey, or ResetKey.

ara::core::Result< void > DiscardPendingChanges () noexcept;

GetAllKeys 函数

Returns a list of all currently available keys of this Key-Value Storage. The list of keys is only accurate if no key-value pair is added or deleted at the same time. This method uses transaction semantics, it sees the current state of transaction, not the actual physical storage.

ara::core::Result< ara::core::Vector< ara::core::String > > GetAllKeys () const noexcept;

GetCurrentValueSize 函数

Returns the size (in bytes) of the value assigned to a key of this Key-Value Storage. GetCurrentValueSize may be delayed by an ongoing call from another thread to RemoveAllKeys or DiscardPendingChanges, or to SetValue, RemoveKey, RecoverKey, or ResetKey for the same key-value pair. This method uses transaction semantics, it sees the current state of transaction, not the actual physical storage.

ara::core::Result< std::uint64_t > GetCurrentValueSize (ara::core::StringView key) const noexcept;

GetValue 函数 2

Returns the value assigned to a key of this KeyValueStorage. This method should only be used to access very large values repeatedly. GetValue may be delayed by an ongoing call from another thread to RemoveAllKeys or Discard PendingChanges, or to SetValue, RemoveKey, RecoverKey, or ResetKey for the same key-value pair. This method uses transaction semantics, it sees the current state of transaction, not the actual physical storage.

重载 GetValue 2

template <class T> ara::core::Result< void > GetValue (ara::core::StringView key, T &value) const noexcept; SWS_PER_00044

template <class T> ara::core::Result< T > GetValue (ara::core::StringView key) const noexcept; SWS_PER_00332

KeyExists 函数

Checks if a key-value pair exists in this Key-Value Storage. The result is only accurate if no key-value pair is added or deleted at the same time. E.g. when a key-value pair is removed in another thread directly after this function returned "true", the result is not valid anymore. This method uses transaction semantics, it sees the current state of transaction, not the actual physical storage.

ara::core::Result< bool > KeyExists (ara::core::StringView key) const noexcept;

RecoverKey 函数

Recovers a single key-value pair of this Key Value Storage. This method allows to recover a single key-value pair when the redundancy checks fail. This method does a best-effort recovery of the key-value pair. After recovery, the key-value pair might contain outdated or initial content, or might be lost. RecoverKey may be delayed by an ongoing call from another thread to RemoveAllKeys, SyncTo Storage, or DiscardPendingChanges, or to SetValue, GetValue, GetCurrentValueSize, Remove Key, RecoverKey, or ResetKey for the same key-value pair.

ara::core::Result< void > RecoverKey (ara::core::StringView key) noexcept;

RemoveAllKeys 函数

Removes all key-value pairs and associated values from this Key-Value Storage. RemoveAllKeys may be delayed by an ongoing call from another thread to RemoveAllKeys, SyncToStorage, DiscardPendingChanges, SetValue, GetValue, GetCurrentValueSize, Remove Key, RecoverKey, or ResetKey. This method uses transaction semantics, the changes only take effect when SyncToStorage is called.

ara::core::Result< void > RemoveAllKeys () noexcept;

RemoveKey 函数

Removes a key and the associated value from this Key-Value Storage. RemoveKey may be delayed by an ongoing call from another thread to RemoveAllKeys, SyncTo Storage, or DiscardPendingChanges, or to SetValue, GetValue, GetCurrentValueSize, Remove Key, RecoverKey, or ResetKey for the same key-value pair. This method uses transaction semantics, the changes only take effect when SyncToStorage is called.

ara::core::Result< void > RemoveKey (ara::core::StringView key) noexcept;

ResetKey 函数

Resets a key of this Key-Value Storage to its initial value. ResetKey allows to reset a single key to its initial value. If the key is currently not available in the Key-Value Storage, it is re-created. Afterwards, the key-value pair will appear in both cases as if it was newly installed from the current Target Configuration. ResetKey will fail with kInitValueNotAvailable when neither Application Design nor Target Configuration define an initial value for the key. ResetKey may be delayed by an ongoing call from another thread to RemoveAllKeys, SyncTo Storage, or DiscardPendingChanges, or to SetValue, GetValue, GetCurrentValueSize, Remove Key, RecoverKey, or ResetKey for the same key-value pair.

ara::core::Result< void > ResetKey (ara::core::StringView key) noexcept;

SetValue 函数

Stores a key-value pair in this Key-Value Storage. If a value already exists and has the same data type as the new value, it is overwritten. If the new value has a different data type than the stored value, kDataTypeMismatch is returned. SetValue may be delayed by an ongoing call from another thread to RemoveAllKeys, SyncTo Storage, or DiscardPendingChanges, or to SetValue, GetValue, GetCurrentValueSize, Remove Key, RecoverKey, or ResetKey for the same key-value pair. This method uses transaction semantics, the changes only take effect when SyncToStorage is called.

template <class T> ara::core::Result< void > SetValue (ara::core::StringView key, const T &value) noexcept;

SyncToStorage 函数

Flushes changed key-value pairs of the Key-Value Storage to the physical storage. SyncToStorage may be delayed by an ongoing call from another thread to RemoveAllKeys, DiscardPendingChanges, SetValue, RemoveKey, RecoverKey, or ResetKey.

ara::core::Result< void > SyncToStorage () noexcept;

运算符

operator= 函数 2

The move assignment operator for KeyValueStorage shall not be used.

重载 = 2

KeyValueStorage & operator= (KeyValueStorage &&kvs)=delete; SWS_PER_00323

KeyValueStorage & operator= (const KeyValueStorage &)=delete; SWS_PER_00325

点击条目以查看其关系。

方法文档

函数 DiscardPendingChanges [SWS_PER_00365] Upstream: RS_PER_00002, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > DiscardPendingChanges () noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 73a36630080a 来源

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用法与语义

类 ara::per::KeyValueStorage（[SWS_PER_00365]）的同步成员函数 DiscardPendingChanges 由头文件 ara/per/key_value_storage.h 提供。它不接受任何参数并返回一个 ara::core::Result<void>。其目的是放弃自上次调用 SyncToStorage 或自通过 OpenKeyValueStorage() 打开以来在键值存储实例上产生的所有待处理更改 [SWS_PER_00365]。

交互与事务行为

写入操作（如 SetValue [SWS_PER_00046]、RemoveKey [SWS_PER_00047] 和 RemoveAllKeys [SWS_PER_00048]）遵循事务语义。它们的更改只有在调用 SyncToStorage 后才会持久写入物理存储介质 [SWS_PER_00049]。通过 DiscardPendingChanges，这些未保存的修改将被回滚，从而通过 GetCurrentValueSize 进行的查询也会再次反映先前的事务初始状态 [SWS_PER_00554]。

错误处理与并发

在发生错误时，结果包含特定于制造商的错误或来自 PerErrc 且具有定义回滚语义的错误代码 [SWS_PER_00365]：

PerErrc::kIllegalWriteAccess：当存储为只读，或者在 Write-Only-Once 配置下键已存在时。
PerErrc::kPhysicalStorageFailure：当访问物理存储介质失败时。
PerErrc::kIntegrityCorrupted、PerErrc::kValidationFailed、PerErrc::kEncryptionFailed 或 PerErrc::kAuthenticationFailed：在完整性损失、验证错误、解密错误或 MAC 校验失败时。

该方法被声明为 noexcept、异常安全（exception safe）以及线程安全（thread-safe）[SWS_PER_00365]。然而，如果其他线程中并行活动着对 SyncToStorage、SetValue、RemoveKey、RemoveAllKeys、ResetKey 或 RecoverKey 的调用，则执行可能会延迟 [SWS_PER_00365] [SWS_PER_00426] [SWS_PER_00427]。

本段文本由人工智能生成，并根据 AUTOSAR 规范进行了整理。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
PerErrc::kIllegalWriteAccess	rollback_semantics Returned if the Key-Value Storage is configured as read- only, or if it is configured as write-only-once and the key already exists.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00365
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00365@rel:R25-11#32a43eaa
Content hash: 32a43eaa
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00365

Status: valid/unmigrated Version: rel:R25-11#f3496212 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00365@rel:R25-11#f3496212

Recorded Revisions (8):

R25-11rel:R25-11#0793e9a52026-09-30
R19-11rel:R19-11#90dcd0d22026-10-14
R20-11rel:R20-11#306302ca2026-10-14
R21-11rel:R21-11#5bb9ceb52026-10-14
R22-11rel:R22-11#6374aaa62026-10-14
R23-11rel:R23-11#7a4bc2902026-10-14
R24-11rel:R24-11#fd18fb832026-10-14
R25-11rel:R25-11#f34962122026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 GetAllKeys [SWS_PER_00042] Upstream: RS_PER_00003, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< ara::core::Vector< ara::core::String > > GetAllKeys () const noexcept;

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

Typ	Beschreibung
ara::core::Result<ara::core::Vector<ara::core::String > >	A Result containing a list of available keys. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00042
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00042@rel:R25-11#6df9cad8
Content hash: 6df9cad8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00042

Status: valid/unmigrated Version: rel:R25-11#7764796d Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00042@rel:R25-11#7764796d

Recorded Revisions (8):

R25-11rel:R25-11#b9c10dc72026-09-30
R19-11rel:R19-11#dc305f7c2026-10-14
R20-11rel:R20-11#5ed793b42026-10-14
R21-11rel:R21-11#d356f6902026-10-14
R22-11rel:R22-11#ef6f96bc2026-10-14
R23-11rel:R23-11#13f7a5a82026-10-14
R24-11rel:R24-11#84dcd6932026-10-14
R25-11rel:R25-11#7764796d2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 GetCurrentValueSize [SWS_PER_00554] Upstream: RS_PER_00017, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< std::uint64_t > GetCurrentValueSize (ara::core::StringView key) const noexcept;

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kKeyNotFound rollback_semantics

Parameter (in)

Parameter	Beschreibung
key	The key to look up.

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::uint64_t >	A Result containing the size of the value in bytes. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Returned if the provided key does not exist in the Key-Value
Storage.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00554
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00554@rel:R25-11#c80c0857
Content hash: c80c0857
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00554

Status: valid/unmigrated Version: rel:R25-11#24655af4 Versionshistorie & Revisions (1 transition, 5 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00554@rel:R25-11#24655af4

Recorded Revisions (5):

R25-11rel:R25-11#83415bd32026-09-30
R22-11rel:R22-11#929002202026-10-14
R23-11rel:R23-11#de5e8c192026-10-14
R24-11rel:R24-11#031b61af2026-10-14
R25-11rel:R25-11#24655af42026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 GetValue [SWS_PER_00044] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00141, RS_AP_00159

template <class T> ara::core::Result< void > GetValue (ara::core::StringView key, T &value) const noexcept;

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kKeyNotFound rollback_semantics

Template-Parameter

Parameter	Beschreibung
T	The type of the value that shall be retrieved.

Parameter (in)

Parameter	Beschreibung
key	The key to look up.

Parameter (out)

Parameter	Beschreibung
value	The retrieved value.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Returned if the provided key does not exist in the Key-Value
Storage.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kDataTypeMismatch	rollback_semantics Returned if the data type of stored value does not match the templated type.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00044
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00044@rel:R25-11#f1a9859c
Content hash: f1a9859c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00044

Status: valid/unmigrated Version: rel:R25-11#d1fc24ca Versionshistorie & Revisions (1 transition, 5 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00044@rel:R25-11#d1fc24ca

Recorded Revisions (5):

R25-11rel:R25-11#51af7b752026-09-30
R22-11rel:R22-11#aba3314c2026-10-14
R23-11rel:R23-11#5ce84da62026-10-14
R24-11rel:R24-11#e55139fe2026-10-14
R25-11rel:R25-11#d1fc24ca2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 GetValue [SWS_PER_00332] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00159

template <class T> ara::core::Result< T > GetValue (ara::core::StringView key) const noexcept;

Returns the value assigned to a key of this Key-Value Storage. GetValue may be delayed by an ongoing call from another thread to RemoveAllKeys or Discard PendingChanges, or to SetValue, RemoveKey, RecoverKey, or ResetKey for the same key-value pair. This method uses transaction semantics, it sees the current state of transaction, not the actual physical storage.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kKeyNotFound rollback_semantics

Template-Parameter

Parameter	Beschreibung
T	The type of the value that shall be retrieved.

Parameter (in)

Parameter	Beschreibung
key	The key to look up.

Rückgabewert

Typ	Beschreibung
ara::core::Result< T >	A Result containing the retrieved value. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Returned if the provided key does not exist in the Key-Value
Storage.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kDataTypeMismatch	rollback_semantics Returned if the data type of stored value does not match the templated type.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00332
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00332@rel:R25-11#cf8add63
Content hash: cf8add63
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00332

Status: valid/unmigrated Version: rel:R25-11#dcb7cd2f Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00332@rel:R25-11#dcb7cd2f

Recorded Revisions (8):

R25-11rel:R25-11#f6c15de42026-09-30
R19-11rel:R19-11#e0b2cbd72026-10-14
R20-11rel:R20-11#817780202026-10-14
R21-11rel:R21-11#efed588e2026-10-14
R22-11rel:R22-11#cb63ddd02026-10-14
R23-11rel:R23-11#03fe0a512026-10-14
R24-11rel:R24-11#e6d6eef02026-10-14
R25-11rel:R25-11#dcb7cd2f2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 KeyExists [SWS_PER_00043] Upstream: RS_PER_00003, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< bool > KeyExists (ara::core::StringView key) const noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： d5f804c0cf2d 来源

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类ara::per::KeyValueStorage的同步方法KeyExists检查存储中是否存在特定的键值对[SWS_PER_00043]。待检查的类型为ara::core::StringView的键key作为输入参数传递[SWS_PER_00043]。返回值是一个ara::core::Result<bool>，如果能定位到该键，则包含true，否则包含false[SWS_PER_00043]。该函数声明为const以及noexcept，并且是异常安全的（exception safe）[SWS_PER_00043]。

在语义和并发性方面，KeyExists基于事务工作：它反映事务的当前状态，而不一定反映物理存储[SWS_PER_00043]。尽管执行是线程安全的（thread-safe），但仅当没有同时添加或删除键值对时，所提供的结果才是精确的[SWS_PER_00043]。例如，如果在返回true后立即在另一个线程中移除了该键值对，则该结果将失效[SWS_PER_00043]。

在出错时，Result包含特定错误代码[SWS_PER_00043]：

StorageFailure：访问物理存储时出错[SWS_PER_00043]。
PerErrc::kIntegrityCorrupted：由于结构完整性受损，无法读取已存储的数据[SWS_PER_00043]。
PerErrc::kValidationFailed：无法确保所存储数据的有效性 [SWS_PER_00043]。
PerErrc::kEncryptionFailed：数据解密失败[SWS_PER_00043]。
PerErrc::kAuthenticationFailed：MAC 校验失败[SWS_PER_00043]。
也可以返回厂商特定错误（vendor specific error）[SWS_PER_00043]。

此文本由 AI 生成，并基于 AUTOSAR R25-11 规范。

实现者指南即将推出（复杂度 I1）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kPhysical rollback_semantics

Parameter (in)

Parameter	Beschreibung
key	The key that shall be checked.

Rückgabewert

Typ	Beschreibung
ara::core::Result< bool >	A Result containing true if the key could be located or false if it couldn’t. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be read because the structural integrity is corrupted.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00043
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00043@rel:R25-11#05e209e3
Content hash: 05e209e3
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00043

Status: valid/unmigrated Version: rel:R25-11#e65b8880 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00043@rel:R25-11#e65b8880

Recorded Revisions (8):

R25-11rel:R25-11#e8b3c8032026-09-30
R19-11rel:R19-11#acb4571e2026-10-14
R20-11rel:R20-11#508cbca52026-10-14
R21-11rel:R21-11#198de15f2026-10-14
R22-11rel:R22-11#4b0b474d2026-10-14
R23-11rel:R23-11#b85446a12026-10-14
R24-11rel:R24-11#416f86462026-10-14
R25-11rel:R25-11#e65b88802026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 KeyValueStorage [SWS_PER_00322] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00121, RS_AP_00129, RS_AP_00145, RS_AP_00159

KeyValueStorage (KeyValueStorage &&kvs)=delete;

The move constructor for KeyValueStorage shall not be used.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00322
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00322@rel:R25-11#61237264
Content hash: 61237264
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00322

Status: valid/unmigrated Version: rel:R25-11#225c60f1 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00322@rel:R25-11#225c60f1

Recorded Revisions (8):

R25-11rel:R25-11#98b7adb12026-09-30
R19-11rel:R19-11#061b66e82026-10-14
R20-11rel:R20-11#61caa7ac2026-10-14
R21-11rel:R21-11#0d2d108a2026-10-14
R22-11rel:R22-11#2127e47e2026-10-14
R23-11rel:R23-11#1e46b07b2026-10-14
R24-11rel:R24-11#225c60f12026-10-14
R25-11rel:R25-11#225c60f12026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 KeyValueStorage [SWS_PER_00324] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00145

KeyValueStorage (const KeyValueStorage &)=delete;

The copy constructor for KeyValueStorage shall not be used.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00324
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00324@rel:R25-11#fc54ff19
Content hash: fc54ff19
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00324

Status: valid/unmigrated Version: rel:R25-11#3458c64f Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00324@rel:R25-11#3458c64f

Recorded Revisions (8):

R25-11rel:R25-11#b723be562026-09-30
R19-11rel:R19-11#9cddb3192026-10-14
R20-11rel:R20-11#eab3f9102026-10-14
R21-11rel:R21-11#eab3f9102026-10-14
R22-11rel:R22-11#b9dc355d2026-10-14
R23-11rel:R23-11#64874c0d2026-10-14
R24-11rel:R24-11#3458c64f2026-10-14
R25-11rel:R25-11#3458c64f2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 KeyValueStorage [SWS_PER_00459] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00129, RS_AP_00146

KeyValueStorage ()=delete;

The default constructor for KeyValueStorage shall not be used.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00459
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00459@rel:R25-11#66e94dfe
Content hash: 66e94dfe
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00459

Status: valid/unmigrated Version: rel:R25-11#2cda50df Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00459@rel:R25-11#2cda50df

Recorded Revisions (6):

R25-11rel:R25-11#757585242026-09-30
R21-11rel:R21-11#74095de92026-10-14
R22-11rel:R22-11#db0f4fa82026-10-14
R23-11rel:R23-11#4c09eb602026-10-14
R24-11rel:R24-11#2cda50df2026-10-14
R25-11rel:R25-11#2cda50df2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 RecoverKey [SWS_PER_00427] Upstream: RS_PER_00003, RS_PER_00009, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > RecoverKey (ara::core::StringView key) noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 424fba0f9a95 来源

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类 ara::per::KeyValueStorage 的同步方法 RecoverKey 用于在内部冗余检查失败时，尽力而为地恢复单个键值对 [SWS_PER_00427]。它通过参数 key 接收作为 ara::core::StringView 的键标识符，并通过 ara::core::Result<void> 报告成功或错误 [SWS_PER_00427]。恢复后，该键值对可能显示过时的内容或初始值，或者完全丢失 [SWS_PER_00427]。

发生错误时，结果将提供来自 PerErrc 的特定错误代码或特定于制造商的错误 [SWS_PER_00427]：

kKeyNotFound：指定的键在存储中不存在 [SWS_PER_00427]。
kIllegalWriteAccess：存储配置为只读（read-only）[SWS_PER_00427]。
kPhysicalStorageFailure：访问物理存储失败 [SWS_PER_00427]。
kIntegrityCorrupted：结构完整性受损阻止了数据的写入 [SWS_PER_00427]。
kEncryptionFailed 或 kAuthenticationFailed：加解密或 MAC 验证失败 [SWS_PER_00427]。
kOutOfStorageSpace 或 kQuotaExceeded：可用物理内存不足或超出配置的最大大小 [SWS_PER_00427]。

该操作被指定为线程安全且异常安全 [SWS_PER_00427]。然而，如果并发执行诸如 RemoveAllKeys [SWS_PER_00048]、SyncToStorage [SWS_PER_00049] 或 DiscardPendingChanges [SWS_PER_00365] 等存储区范围的操作，调用可能会被延迟 [SWS_PER_00427]。同样，针对同一键同时调用 SetValue [SWS_PER_00046]、GetValue [SWS_PER_00044]、GetCurrentValueSize [SWS_PER_00554]、RemoveKey [SWS_PER_00047]、ResetKey [SWS_PER_00426] 或再次调用 RecoverKey 也会导致延迟 [SWS_PER_00427]。与将条目重置为其交付状态的 ResetKey [SWS_PER_00426] 不同，RecoverKey 会尝试进行数据恢复 [SWS_PER_00427]。

本使用说明基于规范自动生成。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kKeyNotFound rollback_semantics

Parameter (in)

Parameter	Beschreibung
key	The key to be recovered.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Returned if the provided key does not exist in the Key-Value
Storage.
PerErrc::kIllegalWriteAccess	rollback_semantics Returned if the Key-Value Storage is configured as read- only.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the recovered value.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the recovered value would exceed the configured maximumAllowedSize of the Key-Value Storage.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00427
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00427@rel:R25-11#8a69e8e3
Content hash: 8a69e8e3
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00427

Status: valid/unmigrated Version: rel:R25-11#aaccab12 Versionshistorie & Revisions (1 transition, 7 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00427@rel:R25-11#aaccab12

Recorded Revisions (7):

R25-11rel:R25-11#1ff272ae2026-09-30
R20-11rel:R20-11#2a43812a2026-10-14
R21-11rel:R21-11#d955febb2026-10-14
R22-11rel:R22-11#e216dd632026-10-14
R23-11rel:R23-11#9839d1302026-10-14
R24-11rel:R24-11#4dc9fbc22026-10-14
R25-11rel:R25-11#aaccab122026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 RemoveAllKeys [SWS_PER_00048] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > RemoveAllKeys () noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 0ae35af4fc43 来源未决问题（1）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用法与事务语义

类 ara::per::KeyValueStorage 的方法 RemoveAllKeys 从存储中移除所有键值对及其关联内容 [SWS_PER_00048]。该函数被同步调用，没有传入参数，并使用 noexcept 指定 [SWS_PER_00048]。该操作遵循事务语义：只有在随后调用 SyncToStorage [SWS_PER_00049] 时，删除所有键的操作才在物理存储中持久生效 [SWS_PER_00048]。在进行中的事务内，诸如 GetValue [SWS_PER_00332] 等读取操作或通过 GetCurrentValueSize [SWS_PER_00554] 进行的大小查询会立即反映清空后的状态 [SWS_PER_00044]。

错误处理

作为返回值提供 ara::core::Result<void> [SWS_PER_00048]。如果发生错误，则应用回滚语义 [SWS_PER_00048]。可能的错误包括：

存储配置为只读时的访问违规（Interpretation：这可能对应于错误码 PerErrc::kIllegalWrite）[SWS_PER_00048]，问题 Q-a820d779e19ac5c9 (未决)
在访问物理存储介质出错时的 PerErrc::kPhysicalStorageFailure [SWS_PER_00048]，
结构数据完整性受损时的 PerErrc::kIntegrityCorrupted [SWS_PER_00048]，
加密/解密或 MAC 校验失败时的 PerErrc::kEncryptionFailed 以及 PerErrc::kAuthenticationFailed [SWS_PER_00048]，以及厂商特定错误。

并发性与交互

该方法被归类为 thread-safe 和 exception safe [SWS_PER_00048]。但是，如果另一个线程中同时有 RemoveAllKeys、SyncToStorage [SWS_PER_00049]、SetValue [SWS_PER_00046]、RemoveKey [SWS_PER_00047]、ResetKey [SWS_PER_00426] 或 RecoverKey [SWS_PER_00427] 的调用处于活动状态，则执行可能会被延迟 [SWS_PER_00048]。

本段文本由 AI 基于规范要求生成。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kIllegalWrite rollback_semantics

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Access	Returned if the Key-Value Storage is configured as read- only.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00048
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00048@rel:R25-11#025d80d7
Content hash: 025d80d7
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00048

Status: valid/unmigrated Version: rel:R25-11#098d4bc1 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00048@rel:R25-11#098d4bc1

Recorded Revisions (8):

R25-11rel:R25-11#8a8820ba2026-09-30
R19-11rel:R19-11#1050c61d2026-10-14
R20-11rel:R20-11#68ed9c542026-10-14
R21-11rel:R21-11#b0a3d35f2026-10-14
R22-11rel:R22-11#4ff9fb912026-10-14
R23-11rel:R23-11#c2afbb972026-10-14
R24-11rel:R24-11#5988f1162026-10-14
R25-11rel:R25-11#098d4bc12026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 RemoveKey [SWS_PER_00047] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > RemoveKey (ara::core::StringView key) noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： ea5f39b17dd8 来源

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类 ara::per::KeyValueStorage 的同步成员函数 RemoveKey 用于从键值存储（Key-Value Storage）中移除键及其关联值 [SWS_PER_00047]。它通过参数 key 接收要移除的键的标识符作为 ara::core::StringView，并返回 ara::core::Result<void> [SWS_PER_00047]。

该操作遵循事务语义：修改不会立即在物理存储中持久化，而是仅在显式调用同步已修改键值对的 SyncToStorage [SWS_PER_00047] 时才生效 [SWS_PER_00049]。在同步之前，未决的修改可以通过 DiscardPendingChanges 丢弃 [SWS_PER_00365]。如 GetValue [SWS_PER_00044]、[SWS_PER_00332] 或 GetCurrentValueSize [SWS_PER_00554] 等读取访问同样作用于事务状态，并能立即反映出该删除。

在并发性方面，该方法被指定为线程安全（thread-safe）和异常安全（exception safe）[SWS_PER_00047]。如果另一个线程中并发执行 RemoveAllKeys、SyncToStorage 或 DiscardPendingChanges，或者同时有 SetValue、GetValue、GetCurrentValueSize、RemoveKey、RecoverKey 或 ResetKey 等操作访问同一键值对，则调用可能会被延迟 [SWS_PER_00047]。

如果在执行过程中发生错误，将应用回滚语义，并且返回的结果对象包含错误码 [SWS_PER_00047]：

PerErrc::kKeyNotFound：指定的键在存储中不存在 [SWS_PER_00047]。
PerErrc::kIllegalWriteAccess：键值存储被配置为只读（read-only）[SWS_PER_00047]。
PerErrc::kPhysicalStorageFailure：对物理存储介质的访问失败 [SWS_PER_00047]。
PerErrc::kIntegrityCorrupted：由于结构完整性受损导致写入失败 [SWS_PER_00047]。
PerErrc::kEncryptionFailed 或 PerErrc::kAuthenticationFailed：加密或解密失败，或者 MAC 计算/校验出错 [SWS_PER_00047]。

本使用说明仅基于针对 Release R25-11 的 AUTOSAR Adaptive 平台规范。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kKeyNotFound rollback_semantics

Parameter (in)

Parameter	Beschreibung
key	The key to be removed.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Returned if the provided key does not exist in the Key-Value
Storage.
PerErrc::kIllegalWriteAccess	rollback_semantics Returned if the Key-Value Storage is configured as read- only.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00047
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00047@rel:R25-11#cc95b879
Content hash: cc95b879
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00047

Status: valid/unmigrated Version: rel:R25-11#60324d85 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00047@rel:R25-11#60324d85

Recorded Revisions (8):

R25-11rel:R25-11#4afcff802026-09-30
R19-11rel:R19-11#653b04072026-10-14
R20-11rel:R20-11#0d9118072026-10-14
R21-11rel:R21-11#53a1e66d2026-10-14
R22-11rel:R22-11#6d261f9c2026-10-14
R23-11rel:R23-11#8d4fd37e2026-10-14
R24-11rel:R24-11#e99607a92026-10-14
R25-11rel:R25-11#60324d852026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 ResetKey [SWS_PER_00426] Upstream: RS_PER_00003, RS_PER_00009, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > ResetKey (ara::core::StringView key) noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： ddb1025237e2 来源

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

同步方法 ResetKey 将 ara::per::KeyValueStorage 实例中的单个键值对重置为其初始值 [SWS_PER_00426]。标识符 key 作为 ara::core::StringView 作为参数传递 [SWS_PER_00426]。如果该键当前在存储中不存在，则会新建该键。在这两种情况下，该条目的状态随后均对应于从当前 Target Configuration 全新安装的状态 [SWS_PER_00426]。该函数声明为 noexcept 并返回 ara::core::Result<void> [SWS_PER_00426]。

错误处理

如果在执行时发生错误，Result 对象会返回相应的错误代码 [SWS_PER_00426]：

PerErrc::kInitValueNotAvailable：如果在 Application Design 和 Target Configuration 中均未为该键定义初始值（回滚语义）[SWS_PER_00426]。
kIllegalWrite：如果 Key-Value Storage 配置为只读（read-only）[SWS_PER_00426]。
PerErrc::kPhysicalStorageFailure 或 PerErrc::kOutOfStorageSpace：在物理存储访问错误或存储空间不足时（无回滚语义）[SWS_PER_00426]。
PerErrc::kIntegrityCorrupted、PerErrc::kEncryptionFailed、PerErrc::kAuthenticationFailed 或 PerErrc::kQuotaExceeded：在完整性违规、加密和身份验证错误或超出配置的 AllowedSize 时（各自具有回滚语义）[SWS_PER_00426]。

并发性与交互

该函数是线程安全且异常安全的 [SWS_PER_00426]。然而，如果来自另一个线程的存储范围操作（例如 RemoveAllKeys [SWS_PER_00048]、SyncToStorage [SWS_PER_00049] 或 DiscardPendingChanges [SWS_PER_00365]）并行处于活动状态，则调用可能会被延迟。同样，通过 SetValue [SWS_PER_00046]、GetValue [SWS_PER_00044] [SWS_PER_00332]、GetCurrentValueSize [SWS_PER_00554]、RemoveKey [SWS_PER_00047]、RecoverKey [SWS_PER_00427] 或另一个 ResetKey 对同一键的并发访问也会导致延迟 [SWS_PER_00426]。

此使用说明是基于 AUTOSAR Adaptive R25-11 规范自动创建的。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kIllegalWrite rollback_semantics

Parameter (in)

Parameter	Beschreibung
key	The key to be reset.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Access	Returned if the Key-Value Storage is configured as read- only.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails.
PerErrc::kInitValueNotAvailable	rollback_semantics Returned if no intitial value was configured for this key.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the initial value.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the initial value would exceed the configured maximum AllowedSize of the Key-Value Storage.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00426
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00426@rel:R25-11#131317c0
Content hash: 131317c0
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00426

Status: valid/unmigrated Version: rel:R25-11#e8b55641 Versionshistorie & Revisions (1 transition, 7 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00426@rel:R25-11#e8b55641

Recorded Revisions (7):

R25-11rel:R25-11#cb5662c22026-09-30
R20-11rel:R20-11#0af4dfeb2026-10-14
R21-11rel:R21-11#504218172026-10-14
R22-11rel:R22-11#e62113552026-10-14
R23-11rel:R23-11#221d69462026-10-14
R24-11rel:R24-11#e9b91b262026-10-14
R25-11rel:R25-11#e8b556412026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 SetValue [SWS_PER_00046] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00159

template <class T> ara::core::Result< void > SetValue (ara::core::StringView key, const T &value) noexcept;

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kIllegalWrite rollback_semantics

Template-Parameter

Parameter	Beschreibung
T	The type of the value that shall be set.

Parameter (in)

Parameter	Beschreibung
key	The key to assign the value to.
value	The value to store.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Access	Returned if the Key-Value Storage is configured as read- only, or if it is configured as write-only-once and the key already exists.
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails.
PerErrc::kDataTypeMismatch	rollback_semantics Returned if the data type of an already stored value does not match the templated type.
PerErrc::kOutOfStorageSpace	rollback_semantics Returned if the available physical storage space is insufficient for the new value.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the new value would exceed the configured maximum AllowedSize of the Key-Value Storage.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating or checking the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00046
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00046@rel:R25-11#a4b23fa1
Content hash: a4b23fa1
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00046

Status: valid/unmigrated Version: rel:R25-11#7952a862 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00046@rel:R25-11#7952a862

Recorded Revisions (8):

R25-11rel:R25-11#914345842026-09-30
R19-11rel:R19-11#394485ea2026-10-14
R20-11rel:R20-11#9bd70fdb2026-10-14
R21-11rel:R21-11#fc6359392026-10-14
R22-11rel:R22-11#f00787ed2026-10-14
R23-11rel:R23-11#640b066a2026-10-14
R24-11rel:R24-11#6fe6b6b92026-10-14
R25-11rel:R25-11#7952a8622026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 SyncToStorage [SWS_PER_00049] Upstream: RS_PER_00002, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< void > SyncToStorage () noexcept;

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 31e98920341c 来源

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类 ara::per::KeyValueStorage 的同步方法 SyncToStorage 将已修改的键值对从内存缓冲区持久写入物理存储 [SWS_PER_00049]。它不接受任何参数并返回 ara::core::Result<void>，声明为 noexcept，并被指定为异常安全且线程安全 [SWS_PER_00049]。

交互与事务语义

修改性操作如 SetValue [SWS_PER_00046]、RemoveKey [SWS_PER_00047] 和 RemoveAllKeys [SWS_PER_00048] 使用事务语义。它们的更改只有在调用 SyncToStorage 时才会生效 [SWS_PER_00046]。如果要在写入之前放弃未决的修改，也可以调用 DiscardPendingChanges [SWS_PER_00365]。

并发性

虽然该函数是线程安全的，但如果另一个线程中同时有 SetValue、RemoveKey、RemoveAllKeys、DiscardPendingChanges、RecoverKey 或 ResetKey 等操作处于活动状态，执行可能会被延迟 [SWS_PER_00049]。

错误处理

如果同步失败，Result 将提供错误码 [SWS_PER_00049]：

具有回滚语义的错误（更改被回滚）：PerErrc::kIntegrityCorrupted、PerErrc::kEncryptionFailed、PerErrc::kAuthenticationFailed、PerErrc::kQuotaExceeded 以及 PerErrc::kIllegalWrite [SWS_PER_00049]。
无回滚语义的错误：物理访问错误时的 PerErrc::kPhysicalStorageFailure 以及存储空间不足时的 PerErrc::kOutOfStorageSpace [SWS_PER_00049]。
配置错误：当存储配置为只读时，或者在仅写一次情况下键已存在时的错误码 Access [SWS_PER_00049]。

本使用说明基于 AUTOSAR 规范 R25-11 自动生成。

实现者指南即将推出（复杂度 I2）

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kIllegalWrite rollback_semantics

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

Fehlercode	Beschreibung
Access	Returned if the Key-Value Storage is configured as read- only, or if it is configured as write-only-once and the key already exists.
PerErrc::kPhysicalStorageFailure	no_rollback_semantics Returned if access to the physical storage fails.
PerErrc::kIntegrityCorrupted	rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption of stored data fails.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the added/changed values.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the added/changed values would exceed the configured maximumAllowedSize of the Key-Value Storage.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if calculating the MAC of stored data fails.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00049
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00049@rel:R25-11#14743819
Content hash: 14743819
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00049

Status: valid/unmigrated Version: rel:R25-11#bedc7cd3 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00049@rel:R25-11#bedc7cd3

Recorded Revisions (8):

R25-11rel:R25-11#2fe641532026-09-30
R19-11rel:R19-11#a63d7bdd2026-10-14
R20-11rel:R20-11#2b2f8c592026-10-14
R21-11rel:R21-11#5a7863892026-10-14
R22-11rel:R22-11#7ba28f5a2026-10-14
R23-11rel:R23-11#0d431f372026-10-14
R24-11rel:R24-11#111d5e172026-10-14
R25-11rel:R25-11#bedc7cd32026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 operator= [SWS_PER_00323] Upstream: RS_PER_00002, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00145, RS_AP_00159

KeyValueStorage & operator= (KeyValueStorage &&kvs)=delete;

The move assignment operator for KeyValueStorage shall not be used.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00323
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00323@rel:R25-11#678ceb28
Content hash: 678ceb28
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00323

Status: valid/unmigrated Version: rel:R25-11#0d46009f Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00323@rel:R25-11#0d46009f

Recorded Revisions (8):

R25-11rel:R25-11#d0aa05fb2026-09-30
R19-11rel:R19-11#c9df11fd2026-10-14
R20-11rel:R20-11#43e209d42026-10-14
R21-11rel:R21-11#3fa50ca32026-10-14
R22-11rel:R22-11#3a8958662026-10-14
R23-11rel:R23-11#d865b2282026-10-14
R24-11rel:R24-11#0d46009f2026-10-14
R25-11rel:R25-11#0d46009f2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 operator= [SWS_PER_00325] Upstream: RS_PER_00002, RS_AP_00119, RS_AP_00120, RS_AP_00145

KeyValueStorage & operator= (const KeyValueStorage &)=delete;

The copy assignment operator for KeyValueStorage shall not be used.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00325
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00325@rel:R25-11#e84e9152
Content hash: e84e9152
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00325

Status: valid/unmigrated Version: rel:R25-11#7eccc0d0 Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00325@rel:R25-11#7eccc0d0

Recorded Revisions (8):

R25-11rel:R25-11#25bc66e92026-09-30
R19-11rel:R19-11#fec94e692026-10-14
R20-11rel:R20-11#f05ae5d42026-10-14
R21-11rel:R21-11#f05ae5d42026-10-14
R22-11rel:R22-11#10326f822026-10-14
R23-11rel:R23-11#2038e13d2026-10-14
R24-11rel:R24-11#7eccc0d02026-10-14
R25-11rel:R25-11#7eccc0d02026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

函数 ~KeyValueStorage [SWS_PER_00050] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00129, RS_AP_00134, RS_AP_00145, RS_AP_00159

~KeyValueStorage () noexcept;

Destructor for KeyValueStorage.

Header-Datei	#include "ara/per/key_value_storage.h"
Scope	class ara::per::KeyValueStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_PER_00050
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00050@rel:R25-11#c3b8962b
Content hash: c3b8962b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00050

Status: valid/unmigrated Version: rel:R25-11#686fc2dc Versionshistorie & Revisions (1 transition, 8 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_PER_00050@rel:R25-11#686fc2dc

Recorded Revisions (8):

R25-11rel:R25-11#c322006e2026-09-30
R19-11rel:R19-11#d5051f6a2026-10-14
R20-11rel:R20-11#a653a0472026-10-14
R21-11rel:R21-11#a653a0472026-10-14
R22-11rel:R22-11#3e0145ae2026-10-14
R23-11rel:R23-11#8187a0df2026-10-14
R24-11rel:R24-11#686fc2dc2026-10-14
R25-11rel:R25-11#686fc2dc2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

类 ara::per::KeyValueStorage

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

成员图

构造函数和析构函数

方法

运算符

类图

详细视图

构造函数和析构函数

方法

运算符

方法文档

函数 DiscardPendingChanges [SWS_PER_00365] Upstream: RS_PER_00002, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

用法与语义

交互与事务行为

错误处理与并发

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetAllKeys [SWS_PER_00042] Upstream: RS_PER_00003, RS_AP_00119, RS_AP_00120, RS_AP_00127, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetCurrentValueSize [SWS_PER_00554] Upstream: RS_PER_00017, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetValue [SWS_PER_00044] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00141, RS_AP_00159

Template-Parameter

Parameter (in)

Parameter (out)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 GetValue [SWS_PER_00332] Upstream: RS_PER_00003, RS_PER_00010, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00159

Template-Parameter

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 KeyExists [SWS_PER_00043] Upstream: RS_PER_00003, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00139, RS_AP_00159

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 KeyValueStorage [SWS_PER_00322] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00121, RS_AP_00129, RS_AP_00145, RS_AP_00159

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 KeyValueStorage [SWS_PER_00324] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00145

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

函数 KeyValueStorage [SWS_PER_00459] Upstream: RS_PER_00002, RS_AP_00120, RS_AP_00129, RS_AP_00146

Recorded Revisions (6):