فئة 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

دليل المستخدممولَّد بالذكاء الاصطناعي

يدير أزواج المفتاح والقيمة المستمرة عبر عمليات قراءة وكتابة معاملاتية مع مزامنة صريحة.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: 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 مخزن مفتاح-قيمة ذا نوع محدد ضمن Adaptive Platform الخاصة بـ AUTOSAR، والتي تدير البيانات المستمرة كمجموعة من المفاتيح ذات قيم مقترنة بها. وهي تعمل كواجهة أساسية للتطبيقات لتخزين بيانات التطبيق المكوّنة واسترجاعها بصورة مستمرة. يتم الوصول بدلالات المعاملات عبر حالة معاملة داخلية بدلاً من الوصول المباشر إلى وسيط التخزين المادي، كما هو محدد لعمليات القراءة في [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.

خريطة الأعضاء

مخطط الفئة

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

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الفئةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل صفحة الفئة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.جديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

توثيق الدوال

دالة 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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 73a36630080a المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

يتم توفير دالة العضو المتزامنة DiscardPendingChanges للفئة ara::per::KeyValueStorage ([SWS_PER_00365]) عبر ملف الترويسة 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: إذا كانت وحدة التخزين محمية ضد الكتابة أو إذا كان المفتاح موجودًا بالفعل في حالة تكوين الكتابة لمرة واحدة فقط.
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#cbc7e04a
Content hash: cbc7e04a
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#83ef96c3
Content hash: 83ef96c3
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#9fcabbd8
Content hash: 9fcabbd8
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#541e35bf
Content hash: 541e35bf
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#ffb8e219
Content hash: ffb8e219
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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d5f804c0cf2d المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تتحقق الطريقة المتزامنة KeyExists للفئة ara::per::KeyValueStorage مما إذا كان زوج مفتاح-قيمة معين موجوداً في وحدة التخزين [SWS_PER_00043]. ويتم تمرير المفتاح المراد التحقق منه key من النوع ara::core::StringView كمعلمة إدخال [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].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند إلى مواصفة 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#a1c6ac29
Content hash: a1c6ac29
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#dae01a2d
Content hash: dae01a2d
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#536fb3d7
Content hash: 536fb3d7
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#c86a9cff
Content hash: c86a9cff
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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 424fba0f9a95 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الطريقة المتزامنة RecoverKey للفئة ara::per::KeyValueStorage للاستعادة بأفضل جهد لزوج فردي من المفتاح والقيمة عند فشل فحوصات التكرار الداخلية [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].

تم تحديد العملية على أنها آمنة للخيوط (thread-safe) وكذلك آمنة للاستثناءات (exception-safe) [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#8924c3a1
Content hash: 8924c3a1
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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0ae35af4fc43 المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام ودلالات المعاملات

تزيل الدالة RemoveAllKeys للفئة ara::per::KeyValueStorage كافة أزواج المفتاح-القيمة ومحتوياتها المرتبطة من الذاكرة [SWS_PER_00048]. يتم استدعاء الدالة بشكل متزامن، ولا تحتوي على أي معلمات تمرير، وهي محددة بـ noexcept [SWS_PER_00048]. تخضع العملية لدلالات المعاملات (Transaktionssemantik): لا يصبح حذف جميع المفاتيح ساريًا بشكل دائم في الذاكرة الفعلية إلا بمجرد استدعاء 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] كقيمة إرجاع. وإذا حدث خطأ، يتم تطبيق دلالات التراجع (Rollback-Semantik) [SWS_PER_00048]. وتشمل الأخطاء المحتملة ما يلي:

انتهاك الوصول في حالة تكوين الذاكرة للقراءة فقط (تفسير: من المحتمل أن يتوافق هذا مع رمز الخطأ PerErrc::kIllegalWrite) [SWS_PER_00048]، سؤال Q-a820d779e19ac5c9 (مفتوح)
PerErrc::kPhysicalStorageFailure عند حدوث أخطاء أثناء الوصول إلى وسيط التخزين الفعلي [SWS_PER_00048]،
PerErrc::kIntegrityCorrupted في حالة تلف السلامة الهيكلية للبيانات [SWS_PER_00048]،
PerErrc::kEncryptionFailed وكذلك PerErrc::kAuthenticationFailed في حالات فشل التشفير/فك التشفير أو فحص MAC [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].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على متطلبات المواصفة.

دليل المنفِّذ قيد الإعداد (التعقيد 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#2ed7931e
Content hash: 2ed7931e
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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ea5f39b17dd8 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم دالة العضو المتزامنة RemoveKey للفئة ara::per::KeyValueStorage لإزالة مفتاح والقيمة المقترنة به من Key-Value Storage [SWS_PER_00047]. وهي تستقبل معرف المفتاح المراد إزالته كـ ara::core::StringView عبر المعامل key وتُرجع 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: تمت تهيئة Key-Value Storage للقراءة فقط (read-only) [SWS_PER_00047].
PerErrc::kPhysicalStorageFailure: فشل الوصول إلى وسيط التخزين الفعلي [SWS_PER_00047].
PerErrc::kIntegrityCorrupted: تفشل الكتابة بسبب تلف السلامة الهيكلية [SWS_PER_00047].
PerErrc::kEncryptionFailed أو PerErrc::kAuthenticationFailed: يفشل التشفير أو فك التشفير أو يكون حساب/فحص MAC غير صحيح [SWS_PER_00047].

يعتمد إشعار الاستخدام هذا حصريًا على مواصفات منصة 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::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#80f9147b
Content hash: 80f9147b
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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: 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].

معالجة الأخطاء

في حال حدوث خطأ أثناء التنفيذ، يُرجع كائن النتيجة رمز خطأ مطابقًا [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].

التزامن والتفاعل

الدالة آمنة للاستخدام في الخيوط المتعددة (thread-safe) وآمنة من الاستثناءات (exception-safe) [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#1619fe08
Content hash: 1619fe08
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#0aafe73b
Content hash: 0aafe73b
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;

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 31e98920341c المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تكتب الطريقة المتزامنة SyncToStorage للفئة ara::per::KeyValueStorage أزواج المفاتيح والقيم المعدلة من المخزن المؤقت في الذاكرة بشكل دائم في التخزين الفعلي [SWS_PER_00049]. لا تأخذ أي معاملات وتُرجع ara::core::Result<void>، وهي معلنة كـ noexcept ومحددة بأنها آمنة من حيث الاستثناءات وآمنة من حيث خيوط التنفيذ [SWS_PER_00049].

التفاعل ودلالات المعاملات

تستخدم العمليات التعديلية مثل SetValue [SWS_PER_00046] وRemoveKey [SWS_PER_00047] وRemoveAllKeys [SWS_PER_00048] دلالات المعاملات (transaction semantics). ولا تصبح تغييراتها نافذة إلا عند استدعاء SyncToStorage [SWS_PER_00046]. وإذا كان يتعين تجاهل التعديلات المعلقة قبل الكتابة، فيمكن استدعاء DiscardPendingChanges كبديل [SWS_PER_00365].

التزامن

على الرغم من أن الدالة آمنة خيطيًا (thread-safe)، فقد يتأخر التنفيذ إذا كانت هناك عمليات نشطة بالتوازي في خيط آخر مثل 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 عندما تكون وحدة التخزين مهيأة للقراءة فقط (read-only) أو في حالة الكتابة لمرة واحدة فقط (write-only-once) إذا كان المفتاح موجودًا بالفعل [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#ddb75a4c
Content hash: ddb75a4c
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#772acf6b
Content hash: 772acf6b
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#da9dc449
Content hash: da9dc449
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#ead595e2
Content hash: ead595e2
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):