क्लास 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 AUTOSAR Adaptive प्लेटफॉर्म के भीतर एक टाइप किया गया की-वैल्यू स्टोरेज प्रदान करती है, जो संबंधित मानों के साथ कुंजियों के एक सेट के रूप में पर्सिस्टेंट डेटा का प्रबंधन करती है। यह अनुप्रयोगों के लिए कॉन्फ़िगर किए गए अनुप्रयोग डेटा के पर्सिस्टेंट संग्रहण और पुनर्प्राप्ति के लिए प्राथमिक इंटरफ़ेस के रूप में कार्य करती है। एक्सेस सीधे भौतिक स्टोरेज माध्यम के बजाय एक आंतरिक ट्रांज़ैक्शनल अवस्था के माध्यम से ट्रांज़ैक्शनल सेमांटिक्स के साथ होती है, जैसा कि [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]।
अखंडता, क्रिप्टो और हार्डवेयर त्रुटियाँ: पढ़ने के संचालन और SetValue() में भौतिक पहुँच त्रुटियों (PerErrc::kPhysicalStorageFailure) में रोलबैक सेमांटिक्स होते हैं [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

किसी प्रविष्टि के संबंध देखने के लिए उस पर क्लिक करें।

आधार क्लासव्युत्पन्नउपयोग करता हैइनके द्वारा उपयोगइनहेरिटेंससे हटाया गयाइनमें उपयोगइस क्लास में कोई संबंध नहींफ़ंक्शनएआई टिप्पणीक्लास पेज खोलेंक्लास पेज लोड नहीं हो सका।क्रम बदलेंचौड़ाई बदलेंरूपरेखा की चौड़ाई बदलेंखंडपढ़ने का समय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 · जर्मन मूल

उपयोग और सिमेंटिक्स

क्लास ara::per::KeyValueStorage ([SWS_PER_00365]) का सिंक्रोनस मेंबर फ़ंक्शन DiscardPendingChanges हेडर ara/per/key_value_storage.h के माध्यम से प्रदान किया जाता है। यह कोई पैरामीटर स्वीकार नहीं करता है और एक ara::core::Result<void> लौटाता है। इसका उद्देश्य Key-Value Storage इंस्टेंस पर उन सभी लंबित परिवर्तनों को खारिज करना है जो 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-protected) है या 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]।

यह पाठ एक AI द्वारा जनरेट किया गया था और 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#801d55da
Content hash: 801d55da
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#38bd700d
Content hash: 38bd700d
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#968092c2
Content hash: 968092c2
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#2de91e5b
Content hash: 2de91e5b
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#c7e1b9c2
Content hash: c7e1b9c2
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 · जर्मन मूल

क्लास 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#f76fdf89
Content hash: f76fdf89
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#16703c18
Content hash: 16703c18
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#ac28ece8
Content hash: ac28ece8
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#4503a23e
Content hash: 4503a23e
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 · जर्मन मूल

वर्ग 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#a048a74f
Content hash: a048a74f
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 · जर्मन मूल

उपयोग और ट्रांज़ैक्शन सिमेंटिक्स

क्लास 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]। संभावित त्रुटियों में शामिल हैं:

रीड-ओनली कॉन्फ़िगर किए गए स्टोरेज पर पहुँच का उल्लंघन (व्याख्या: यह संभवतः त्रुटि कोड PerErrc::kIllegalWrite के अनुरूप होना चाहिए) [SWS_PER_00048], प्रश्न Q-a820d779e19ac5c9 (खुला)
भौतिक स्टोरेज माध्यम [SWS_PER_00048] तक पहुँचने में त्रुटियों पर PerErrc::kPhysicalStorageFailure,
संरचनात्मक डेटा अखंडता क्षतिग्रस्त होने पर 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#1e32351b
Content hash: 1e32351b
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 · जर्मन मूल

क्लास 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: 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]।

यह उपयोग नोट विशेष रूप से रिलीज़ 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#867e7f66
Content hash: 867e7f66
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]।

त्रुटि प्रबंधन

यदि निष्पादन के दौरान कोई त्रुटि होती है, तो 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#7ecfa21b
Content hash: 7ecfa21b
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#3125724d
Content hash: 3125724d
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 · जर्मन मूल

क्लास ara::per::KeyValueStorage का सिंक्रोनस मेथड SyncToStorage मेमोरी बफर से संशोधित कुंजी-मान युग्मों को स्थायी रूप से भौतिक मेमोरी में लिखता है [SWS_PER_00049]। यह कोई पैरामीटर स्वीकार नहीं करता है और एक ara::core::Result<void> लौटाता है, इसे noexcept के रूप में घोषित किया गया है तथा एक्सेप्शन-सुरक्षित और thread-safe के रूप में निर्दिष्ट किया गया है [SWS_PER_00049]।

पारस्परिक क्रिया और लेन-देन सिमेंटिक्स

SetValue [SWS_PER_00046], RemoveKey [SWS_PER_00047] और RemoveAllKeys [SWS_PER_00048] जैसे संशोधनकारी ऑपरेशन्स लेन-देन सिमेंटिक्स का उपयोग करते हैं। उनके परिवर्तन केवल 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, यदि मेमोरी केवल-पढ़ने के लिए कॉन्फ़िगर की गई है या 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#6b0759eb
Content hash: 6b0759eb
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#a9d3bfd4
Content hash: a9d3bfd4
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#9c7c68b2
Content hash: 9c7c68b2
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#de6a7de2
Content hash: de6a7de2
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):