क्लास ara::per::FileStorage

[SWS_PER_00340] Upstream: RS_PER_00004, RS_AP_00122, RS_AP_00140, RS_AP_00146

class FileStorage final {...};

The File Storage contains a set of files identified by their file names.

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

उपयोगकर्ता गाइडएआई जनित

लगातार फ़ाइलों का प्रबंधन करता है और ब्लॉक-वार पढ़ने और लिखने के लिए RAII-आधारित हैंडल के माध्यम से उन्हें खोलता है।

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 7736cf7ccbd1 उद्गम खुले प्रश्न (2)

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage अद्वितीय फ़ाइल नामों [SWS_PER_00110] के माध्यम से कॉन्फ़िगर की गई लगातार फ़ाइलों के एक सेट के प्रबंधन और खोलने को सक्षम बनाती है। वास्तविक पढ़ने और लिखने की पहुंच UniqueHandle-निर्देशित एक्सेसर्स के माध्यम से होती है, जो स्कोप से बाहर निकलने पर फ़ाइल को स्वचालित रूप से फिर से बंद कर देते हैं [SWS_PER_00114]। चूंकि पहले से खुली फ़ाइलें समवर्ती विलोपन या पुनर्प्राप्ति संचालनों से सुरक्षित होती हैं, इसलिए ऐसे समानांतर एक्सेस PerErrc::kResourceBusy के साथ विफल हो जाते हैं [SWS_PER_00111]।

संदर्भ

क्लास ara::per::FileStorage अद्वितीय फ़ाइल नामों द्वारा पहचानी जाने वाली लगातार फ़ाइलों के एक कॉन्फ़िगर किए गए संग्रह तक पहुंच को समाहित करती है। यह अनुप्रयोगों के लिए एक केंद्रीय इंटरफ़ेस के रूप में कार्य करती है ताकि फ़ाइल संचालन किए जा सकें जैसे कि GetAllFileNames [SWS_PER_00110] के माध्यम से मौजूदा फ़ाइलों को सूचीबद्ध करना, FileExists [SWS_PER_00112] का उपयोग करके अस्तित्व की जांच करना, साथ ही GetFileInfo [SWS_PER_00438] और GetCurrentFileSize [SWS_PER_00407] के माध्यम से मेटाडेटा और फ़ाइल आकार की क्वेरी करना। बाइट स्तर पर प्रत्यक्ष पढ़ने या लिखने की पहुंच स्टोरेज इंस्टेंस पर ही नहीं होती है, बल्कि विशेष एक्सेस ऑब्जेक्ट्स के माध्यम से मध्यस्थता की जाती है, जिन्हें ओपनिंग विधियों द्वारा UniqueHandle के रूप में प्रदान किया जाता है [SWS_PER_00114] [SWS_PER_00113] [SWS_PER_00115]।

जीवनचक्र

FileStorage का इंस्टैंसिएशन सख्त प्रतिबंधों के अधीन है: डिफ़ॉल्ट कंस्ट्रक्टर [SWS_PER_00460] के साथ-साथ कॉपी और मूव कंस्ट्रक्टर [SWS_PER_00328] [SWS_PER_00326] और कॉपी और मूव असाइनमेंट ऑपरेटर [SWS_PER_00329] [SWS_PER_00327] दोनों स्पष्ट रूप से हटा दिए गए हैं। इसलिए FileStorage का एक इंस्टेंस आमतौर पर पर्सिस्टेंस मॉड्यूल के प्लेटफ़ॉर्म-साइड फ़ैक्टरी फ़ंक्शंस के माध्यम से खोला और प्रदान किया जाना चाहिए। प्रश्न (खुला) डिस्ट्रक्टर ~FileStorage अपवाद-सुरक्षित है (noexcept), लेकिन स्पष्ट रूप से थ्रेड-सुरक्षित नहीं के रूप में निर्दिष्ट है [SWS_PER_00330], इसलिए यह सुनिश्चित किया जाना चाहिए कि विनाश के दौरान ऑब्जेक्ट पर कोई समवर्ती कॉल न हो।

चालू संचालन में, FileExists, DeleteFile या फ़ाइलें खोलने जैसे नियमित फ़ाइल संचालन थ्रेड-सुरक्षित डिज़ाइन किए गए हैं [SWS_PER_00111] [SWS_PER_00112] [SWS_PER_00114]। हालांकि, यह ध्यान दिया जाना चाहिए कि GetAllFileNames [SWS_PER_00110] या FileExists [SWS_PER_00112] जैसी स्थिति प्रश्नों के परिणाम केवल तभी सटीक रूप से मान्य होते हैं जब उसी समय किसी अन्य थ्रेड में फ़ाइलें जोड़ी या हटाई नहीं जा रही हों। ऐसा ही GetFileInfo के लिए भी लागू होता है: संशोधन और पहुंच समय के साथ-साथ प्रसंस्करण स्थिति केवल तभी विश्वसनीय रूप से सटीक होती है जब तक कि लक्षित फ़ाइल खुली न हो [SWS_PER_00438]।

उपयोग पथ

एक विशिष्ट उपयोग पथ में जांच, लक्षित रूप से खोलना, एक्सेसर हैंडल के माध्यम से डेटा प्रसंस्करण और अंतिम सफाई शामिल है:

फ़ाइल स्थिति की जांच: एक्सेस करने से पहले, वैकल्पिक रूप से FileExists के माध्यम से यह निर्धारित किया जा सकता है कि कोई वांछित फ़ाइल मौजूद है या नहीं [SWS_PER_00112], या GetAllFileNames के माध्यम से इन्वेंट्री की क्वेरी की जा सकती है [SWS_PER_00110]।
फ़ाइल खोलना: इच्छित एक्सेस मोड के आधार पर, क्लास समर्पित विधियां प्रदान करती है। केवल पढ़ने की पहुंच के लिए OpenFileReadOnly ओवरलोड उपलब्ध हैं [SWS_PER_00114] [SWS_PER_00376] [SWS_PER_00430]। पढ़ने और लिखने की पहुंच के लिए OpenFileReadWrite [SWS_PER_00113] [SWS_PER_00375] [SWS_PER_00429] का उपयोग किया जाता है, जिससे गैर-मौजूद फ़ाइल स्वचालित रूप से नए सिरे से बनाई जाती है। केवल लिखने के लिए OpenFileWriteOnly [SWS_PER_00115] [SWS_PER_00377] [SWS_PER_00431] मौजूद है, जो डिफ़ॉल्ट रूप से फ़ाइल को ट्रंकेट करता है (kTruncate) या इसे नया बनाता है। कई छोटे एक्सेसों में प्रदर्शन में सुधार के लिए, ओवरलोड ब्लॉक-वार पढ़ने या लिखने के लिए उपयोगकर्ता-परिभाषित बफर पास करने की अनुमति देते हैं [SWS_PER_00430] [SWS_PER_00429] [SWS_PER_00431]।
फ़ाइल बंद करना और संसाधन जारी करना: ओपनिंग विधियों द्वारा लौटाया गया ara::core::Result संबंधित एक्सेसर पर एक UniqueHandle को समाहित करता है। जैसे ही यह UniqueHandle अपने स्कोप से बाहर निकलता है, फ़ाइल स्वचालित रूप से बंद हो जाती है [SWS_PER_00114] [SWS_PER_00113] [SWS_PER_00115]। संभवतः, FileStorage में फ़ाइल-संबंधित अधिभोग मार्कर भी इस प्रक्रिया में हटा दिया जाता है। प्रश्न (खुला)
रखरखाव और सफाई: जिन फ़ाइलों की अब आवश्यकता नहीं है, उन्हें DeleteFile से हटा दिया जाता है [SWS_PER_00111]। अखंडता उल्लंघनों के मामले में, RecoverFile अनावश्यक डेटा की सर्वोत्तम-प्रयास पुनर्प्राप्ति प्रदान करता है [SWS_PER_00337], जबकि ResetFile किसी फ़ाइल को उसकी प्रारंभिक प्रावधान सामग्री पर रीसेट करता है या गायब होने पर इसे नया बनाता है [SWS_PER_00338]।

अनुक्रम आरेख: फ़ाइल की जांच और उसे खोलने से लेकर बफ़र प्रसंस्करण और हैंडल के स्कोप द्वारा स्वचालित समापन तक की विशिष्ट प्रक्रिया। स्रोत: [SWS_PER_00112], [SWS_PER_00430], [SWS_PER_00114], [SWS_PER_00111]।

त्रुटि परिदृश्य

FileStorage की विधियां त्रुटि इनम PerErrc का उपयोग करके ara::core::Result के माध्यम से त्रुटियों का संकेत देती हैं। सबसे महत्वपूर्ण त्रुटि स्थितियों में शामिल हैं:

संसाधन विरोध (PerErrc::kResourceBusy): किसी फ़ाइल को खोला, हटाया, पुनर्प्राप्त या रीसेट नहीं किया जा सकता है यदि वह पहले से खुली है या समानांतर में उसी फ़ाइल नाम पर DeleteFile, RecoverFile या ResetFile निष्पादित किया जा रहा है [SWS_PER_00111] [SWS_PER_00114] [SWS_PER_00113] [SWS_PER_00337] [SWS_PER_00338]।
फ़ाइलें नहीं मिलीं (PerErrc::kFileNotFound): तब होता है जब किसी गैर-मौजूद फ़ाइल को केवल पढ़ने के लिए खोला [SWS_PER_00114], हटाया [SWS_PER_00111], क्वेरी किया [SWS_PER_00407] [SWS_PER_00438] या पुनर्प्राप्त [SWS_PER_00337] किया जाना हो।
पहुंच और अनुमति उल्लंघन: यदि स्टोरेज को केवल-पढ़ने के लिए (read-only) कॉन्फ़िगर किया गया है, तो राइटिंग ओपनिंग या विलोपन प्रक्रियाएं PerErrc::kIllegalWriteAccess के साथ विफल हो जाती हैं [SWS_PER_00111] [SWS_PER_00113] [SWS_PER_00115]। अमान्य मोड संयोजनों को PerErrc::kInvalidOpenMode के साथ अस्वीकार कर दिया जाता है [SWS_PER_00114] [SWS_PER_00113]।
स्टोरेज सीमाएं और कोटा: नए निर्माण या वृद्धि पर PerErrc::kOutOfStorageSpace (भौतिक मेमोरी पूर्ण), PerErrc::kTooManyFiles (maxNumberOfFiles से अधिक होना) या PerErrc::kQuotaExceeded (maximumAllowedSize से अधिक होना) हो सकता है [SWS_PER_00113] [SWS_PER_00337] [SWS_PER_00338]।
अखंडता और सुरक्षा त्रुटियां: भौतिक स्टोरेज परत की विफलताओं के मामले में PerErrc::kPhysicalStorageFailure की रिपोर्ट की जाती है। दूषित डेटा संरचनाएं, असफल सत्यापन या क्रिप्टोग्राफ़िक समस्याएं PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed [SWS_PER_00110] [SWS_PER_00112] [SWS_PER_00114] [SWS_PER_00337] में परिणत होती हैं।
प्रारंभिक डेटा का अभाव (PerErrc::kInitValueNotAvailable): ResetFile के माध्यम से रीसेट करते समय विफल हो जाता है यदि न तो Application Design में और न ही लक्ष्य कॉन्फ़िगरेशन में प्रारंभिक मान संग्रहीत किए गए हैं [SWS_PER_00338]।

यह मार्गदर्शिका AUTOSAR Adaptive Platform रिलीज़ R25-11 के विनिर्देश पर आधारित है और ara::per::FileStorage की कार्यात्मक आवश्यकताओं का सार प्रस्तुत करती है।

सदस्य मानचित्र

क्लास आरेख

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

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

इस रिलीज़ के लिए कोई तत्व डेटा उपलब्ध नहीं

कंस्ट्रक्टर और डिस्ट्रक्टर

FileStorage फ़ंक्शन 3

The move constructor for FileStorage shall not be used.

ओवरलोड FileStorage 3

FileStorage (FileStorage &&fs)=delete; SWS_PER_00326

FileStorage (const FileStorage &)=delete; SWS_PER_00328

FileStorage ()=delete; SWS_PER_00460

~FileStorage फ़ंक्शन

Destructor for FileStorage.

~FileStorage () noexcept;

मेथड

DeleteFile फ़ंक्शन

Deletes a file from this File Storage. This operation will fail with kResourceBusy when the file is currently open.

ara::core::Result< void > DeleteFile (ara::core::StringView fileName) noexcept;

FileExists फ़ंक्शन

Checks if a file exists in this File Storage. The result is only accurate if no file is added or deleted at the same time. E.g. when a file is removed in another thread directly after this function returned "true", the result is not valid anymore.

ara::core::Result< bool > FileExists (ara::core::StringView fileName) const noexcept;

GetAllFileNames फ़ंक्शन

Returns a list of all currently available file names of this File Storage. The list of file names is only accurate if no file is added or deleted at the same time.

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

GetCurrentFileSize फ़ंक्शन

Returns the space in bytes currently occupied by the content of a file of this File Storage. The returned size might be inaccurate if any of the instances of a file is invalid or if another operation on the file takes place at the same time.

ara::core::Result< std::uint64_t > GetCurrentFileSize (ara::core::StringView fileName) const noexcept;

GetFileInfo फ़ंक्शन

Returns additional information on a file of this File Storage. The returned FileInfo struct contains information about the times when the file was created, last modified, and last accessed, and about how and by whom the file was created and last modified. The modificationTime, accessTime, and fileModificationState returned in the FileInfo are only accurate if the file is currently not open.

ara::core::Result< FileInfo > GetFileInfo (ara::core::StringView file Name) const noexcept;

OpenFileReadOnly फ़ंक्शन 3

Opens a file of this File Storage for reading with a defined mode. If not otherwise specified by the provided mode, the file is opened with the seek position set to the beginning (corresponding to kAtTheBeginning). The file will be closed when the returned UniqueHandle goes out of scope.

ओवरलोड OpenFileReadOnly 3

ara::core::Result< UniqueHandle< ReadAccessor > > OpenFileReadOnly (ara::core::StringView fileName, OpenMode mode) noexcept;

SWS_PER_00114

ara::core::Result< UniqueHandle< ReadAccessor > > OpenFileReadOnly (ara::core::StringView fileName) noexcept; SWS_PER_00376

ara::core::Result< UniqueHandle< ReadAccessor > > OpenFileReadOnly (ara::core::StringView fileName, OpenMode mode, ara::core::Span< ara::core::Byte > buffer) noexcept;

SWS_PER_00430

OpenFileReadWrite फ़ंक्शन 3

Opens a file of this File Storage for reading and writing with a defined mode. If not otherwise specified by the provided mode, the file is opened with the seek position set to the beginning (corresponding to kAtTheBeginning). If the file does not exist, it is created. The file will be closed when the returned UniqueHandle goes out of scope.

ओवरलोड OpenFileReadWrite 3

ara::core::Result< UniqueHandle< ReadWriteAccessor > > OpenFileRead Write (ara::core::StringView fileName, OpenMode mode) noexcept;

SWS_PER_00113

ara::core::Result< UniqueHandle< ReadWriteAccessor > > OpenFileRead Write (ara::core::StringView fileName) noexcept; SWS_PER_00375

ara::core::Result< UniqueHandle< ReadWriteAccessor > > OpenFileRead Write (ara::core::StringView fileName, OpenMode mode, ara::core::Span< ara::core::Byte > buffer) noexcept;

SWS_PER_00429

OpenFileWriteOnly फ़ंक्शन 3

Opens a file of this File Storage for writing with a defined mode. If not otherwise specified by the provided mode, the file is truncated (corresponding to k Truncate). If the file does not exist, it is created. The file will be closed when the returned UniqueHandle goes out of scope.

ओवरलोड OpenFileWriteOnly 3

ara::core::Result< UniqueHandle< WriteAccessor > > OpenFileWriteOnly (ara::core::StringView fileName, OpenMode mode) noexcept;

SWS_PER_00115

ara::core::Result< UniqueHandle< WriteAccessor > > OpenFileWriteOnly (ara::core::StringView fileName) noexcept; SWS_PER_00377

ara::core::Result< UniqueHandle< WriteAccessor > > OpenFileWriteOnly (ara::core::StringView fileName, OpenMode mode, ara::core::Span< ara::core::Byte > buffer) noexcept;

SWS_PER_00431

RecoverFile फ़ंक्शन

Recovers a file of this File Storage. This method allows to recover a single file when the redundancy checks fail. It will fail with kResourceBusy when the file is currently open. This method does a best-effort recovery of the file. After recovery, the file might show outdated or initial content, or might be lost.

ara::core::Result< void > RecoverFile (ara::core::StringView fileName) noexcept;

ResetFile फ़ंक्शन

Resets a file of this File Storage to its initial content. ResetFile allows to reset a single file to its initial content. If the file is currently not available in the File Storage, it is re-created. Afterwards, the file will appear in both cases as if it was newly installed from the current Target Configuration. It will fail with kResourceBusy when the file is currently open, and with kInitValueNotAvailable when neither Application Design nor Target Configuration define an initial content for the file.

ara::core::Result< void > ResetFile (ara::core::StringView fileName) noexcept;

ऑपरेटर

operator= फ़ंक्शन 2

The move assignment operator for FileStorage shall not be used.

ओवरलोड = 2

FileStorage & operator= (FileStorage &&fs)=delete; SWS_PER_00327

FileStorage & operator= (const FileStorage &)=delete; SWS_PER_00329

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

आधार क्लासव्युत्पन्नउपयोग करता हैइनके द्वारा उपयोगइनहेरिटेंससे हटाया गयाइनमें उपयोगइस क्लास में कोई संबंध नहींफ़ंक्शनएआई टिप्पणीक्लास पेज खोलेंक्लास पेज लोड नहीं हो सका।क्रम बदलेंचौड़ाई बदलेंरूपरेखा की चौड़ाई बदलेंखंडपढ़ने का समयSWS संदर्भआरेखवापस बीच मेंक्रम बदलें या शीर्षक पट्टी पर खींचेंअनडॉक करें – सामग्री में दिखाएँबीच वाले कॉलम में ले जाएँशीर्षक पट्टी में टैब के रूप में डॉक करेंतत्वएआई मॉडलऑडिट डोज़ियर खोलेंडोज़ियरसंक्षिप्त संस्करण खोलेंमध्यम संस्करण खोलेंपूर्ण संस्करण खोलेंडिफ़ॉल्ट दृश्य पुनर्स्थापित करेंडिफ़ॉल्ट दृश्य पुनर्स्थापित हुआपूर्ववत करेंविस्तृत दृश्य बंद करेंसिग्नेचरसामान्य जानकारीमानचुनी गई रिलीज़ तक अंतिम परिवर्तनउसके बाद का अगला परिवर्तनक्लिक: रिलीज़ चुनेंयहाँ छोड़ा नहीं जा सकता: डॉक करने के लिए शीर्षक पट्टी पर, अनडॉक करने के लिए बीच वाले कॉलम में खींचें।नयाबदला गयाअपरिवर्तितहटाया गयाशामिल नहींपरिवर्तनसामग्री में कोई परिवर्तन नहींपहली बारहटाया गया:रिलीज़ डेटा उपलब्ध नहीं है।रिलीज़ डेटा लोड हो रहा है …पाठइस रिलीज़ में शब्दावली दर्ज नहींसेल पर होवर या क्लिक करें: चुनी गई रिलीज़ से तुलना करें · रिलीज़ शीर्षक पर क्लिक करें: रिलीज़ चुनेंरिलीज़ चुनेंविवरणरिलीज़तत्वशब्दावली वाली केवल एक रिलीज़PDF में मौजूद, पाठ अभी आयात नहीं हुआपाठ पहली बार दर्ज{rel} से अपरिवर्तितरिलीज़ के रंगसबसे पुराना रिलीज़नवीनतम रिलीज़

मेथड का प्रलेखन

फ़ंक्शन DeleteFile [SWS_PER_00111] Upstream: RS_PER_00001, RS_PER_00004, 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 > DeleteFile (ara::core::StringView fileName) noexcept;

Deletes a file from this File Storage. This operation will fail with kResourceBusy when the file is currently open.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 4416a2cc7c72 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage का सिंक्रोनस मेथड DeleteFile किसी फ़ाइल को उसके नाम (fileName) के आधार पर फ़ाइल स्टोरेज से हटाता है [SWS_PER_00111]। यह पहचानकर्ता कॉन्फ़िगर किए गए PersistencyFile.fileName से मेल खा सकता है [SWS_PER_00111]। इस कॉल को noexcept के रूप में निर्दिष्ट किया गया है, इसे अपवाद-सुरक्षित तथा थ्रेड-सुरक्षित माना जाता है और यह परिणाम ara::core::Result<void> के माध्यम से रिपोर्ट करता है [SWS_PER_00111]।

कॉल करने से पहले, लक्षित फ़ाइल पर सभी सक्रिय एक्सेस समाप्त होने चाहिए। यदि फ़ाइल वर्तमान में खुली है, तो हटाने की प्रक्रिया त्रुटि PerErrc::kResourceBusy के साथ विफल हो जाती है [SWS_PER_00111]। इसलिए एप्लिकेशन को यह सुनिश्चित करना चाहिए कि OpenFileReadWrite [SWS_PER_00113], OpenFileReadOnly [SWS_PER_00114] या OpenFileWriteOnly [SWS_PER_00115] के माध्यम से पहले बनाए गए UniqueHandle-इंस्टेंस अपने स्कोप से बाहर निकल चुके हों, जिससे फ़ाइल बंद हो जाती है। इसी प्रकार, समान फ़ाइल नाम के लिए RecoverFile [SWS_PER_00337] या ResetFile [SWS_PER_00338] का समानांतर निष्पादन PerErrc::kResourceBusy [SWS_PER_00111] का कारण बनता है।

त्रुटि की स्थिति में, लौटाया गया Result-प्रकार विशिष्ट त्रुटि कारण प्रदान करता है [SWS_PER_00111]:

PerErrc::kFileNotFound: निर्दिष्ट फ़ाइल, फ़ाइल स्टोरेज में मौजूद नहीं है [SWS_PER_00111]।
PerErrc::kIllegalWriteAccess: फ़ाइल स्टोरेज केवल-पढ़ने के लिए (read-only) कॉन्फ़िगर किया गया है [SWS_PER_00111]।
PerErrc::kPhysicalStorageFailure: भौतिक स्टोरेज माध्यम तक एक्सेस विफल हो जाता है (रोलबैक सिमेंटिक्स के बिना) [SWS_PER_00111]।
PerErrc::kIntegrityCorrupted, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed: संरचनात्मक अखंडता, एन्क्रिप्शन/डिक्रिप्शन या MAC सत्यापन में त्रुटियाँ (प्रत्येक रोलबैक सिमेंटिक्स के साथ) और साथ ही निर्माता-विशिष्ट त्रुटियाँ [SWS_PER_00111]।

यह टेक्स्ट एक AI द्वारा जनरेट किया गया था और एक मार्गदर्शन के रूप में कार्य करता है। केवल AUTOSAR दस्तावेज़ीकरण के विनिर्देश ही बाध्यकारी हैं।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

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 File 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::kResourceBusy	rollback_semantics Returned if the file is open, or if RecoverFile or ResetFile with the same file name is currently being executed.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File 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_00111
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00111@rel:R25-11#74da6800
Content hash: 74da6800
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00111

Status: valid/unmigrated Version: rel:R25-11#54be3f24 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_00111@rel:R25-11#54be3f24

Recorded Revisions (8):

R25-11rel:R25-11#9014bbf32026-09-30
R19-11rel:R19-11#878a9ae32026-10-14
R20-11rel:R20-11#c8f140db2026-10-14
R21-11rel:R21-11#35984aa22026-10-14
R22-11rel:R22-11#86df5bb02026-10-14
R23-11rel:R23-11#a507e2692026-10-14
R24-11rel:R24-11#5c96fd1e2026-10-14
R25-11rel:R25-11#54be3f242026-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

फ़ंक्शन FileExists [SWS_PER_00112] Upstream: RS_PER_00001, RS_PER_00004, 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 > FileExists (ara::core::StringView fileName) const noexcept;

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: f0bea0a79212 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage की सिंक्रोनस विधि FileExists जाँचती है कि क्या संबंधित फ़ाइल स्टोरेज में कोई फ़ाइल मौजूद है [SWS_PER_00112]। फ़ंक्शन को noexcept के रूप में घोषित किया गया है और यह कोई C++ अपवाद नहीं फेंकता है [SWS_PER_00112]।

उपयोग

पैरामीटर के रूप में fileName को ara::core::StringView के रूप में पास किया जाता है, जो किसी कॉन्फ़िगर की गई फ़ाइल के पहचानकर्ता PersistencyFile.fileName के अनुरूप हो सकता है [SWS_PER_00112]। रिटर्न मान ara::core::Result<bool> फ़ाइल मिलने पर true लौटाता है, और अन्यथा false [SWS_PER_00112]।

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

यदि जाँच विफल हो जाती है, तो लौटाए गए Result में बूलियन मान नहीं होता है, बल्कि एक त्रुटि कोड होता है [SWS_PER_00112]। निर्दिष्ट त्रुटि कारण हैं:

भौतिक मेमोरी एक्सेस विफल होने पर PerErrc::kPhysicalStorageFailure [SWS_PER_00112],
डेटा की क्षतिग्रस्त संरचनात्मक अखंडता पर PerErrc::kIntegrityCorrupted [SWS_PER_00112],
PerErrc::kValidationFailed, जब संग्रहीत डेटा की वैधता की गारंटी नहीं दी जा सकती [SWS_PER_00112],
विफल डिक्रिप्शन पर PerErrc::kEncryptionFailed [SWS_PER_00112],
विफल MAC सत्यापन पर PerErrc::kAuthenticationFailed [SWS_PER_00112] तथा संभावित विक्रेता-विशिष्ट त्रुटियाँ [SWS_PER_00112]।

समवर्तीता और प्रतिबंध

विधि को थ्रेड-सुरक्षित घोषित किया गया है [SWS_PER_00112]। हालाँकि, प्रदान किया गया जाँच परिणाम केवल तभी सटीक होता है जब तक कि मेमोरी में फ़ाइलों को एक साथ जोड़ा या हटाया न जा रहा हो; उदाहरण के लिए, यदि कोई अन्य थ्रेड true की वापसी के ठीक बाद किसी फ़ाइल को हटा देता है, तो परिणाम पहले से ही अमान्य हो जाता है [SWS_PER_00112]।

यह उपयोग नोट AUTOSAR R25-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

Rückgabewert

Typ	Beschreibung
ara::core::Result< bool >	A Result containing true if the file 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_00112
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00112@rel:R25-11#accae816
Content hash: accae816
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00112

Status: valid/unmigrated Version: rel:R25-11#eff770fd 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_00112@rel:R25-11#eff770fd

Recorded Revisions (8):

R25-11rel:R25-11#b7ca36222026-09-30
R19-11rel:R19-11#bb51dd332026-10-14
R20-11rel:R20-11#69021fcb2026-10-14
R21-11rel:R21-11#a1fece9f2026-10-14
R22-11rel:R22-11#2147fabd2026-10-14
R23-11rel:R23-11#cd2da2ba2026-10-14
R24-11rel:R24-11#421ba73d2026-10-14
R25-11rel:R25-11#eff770fd2026-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

फ़ंक्शन FileStorage [SWS_PER_00326] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00121, RS_AP_00129, RS_AP_00145, RS_AP_00159

FileStorage (FileStorage &&fs)=delete;

The move constructor for FileStorage shall not be used.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage

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

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

Status: valid/unmigrated Version: rel:R25-11#62da63ae 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_00326@rel:R25-11#62da63ae

Recorded Revisions (8):

R25-11rel:R25-11#201fb7f12026-09-30
R19-11rel:R19-11#ee041ade2026-10-14
R20-11rel:R20-11#b225c72d2026-10-14
R21-11rel:R21-11#805cfb8b2026-10-14
R22-11rel:R22-11#a9c3021b2026-10-14
R23-11rel:R23-11#4fc6a3d12026-10-14
R24-11rel:R24-11#62da63ae2026-10-14
R25-11rel:R25-11#62da63ae2026-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

फ़ंक्शन FileStorage [SWS_PER_00328] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00145

FileStorage (const FileStorage &)=delete;

The copy constructor for FileStorage shall not be used.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage

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

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

Status: valid/unmigrated Version: rel:R25-11#457a8c69 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_00328@rel:R25-11#457a8c69

Recorded Revisions (8):

R25-11rel:R25-11#210f83712026-09-30
R19-11rel:R19-11#b53f0afb2026-10-14
R20-11rel:R20-11#4fbd234e2026-10-14
R21-11rel:R21-11#4fbd234e2026-10-14
R22-11rel:R22-11#3d9e304b2026-10-14
R23-11rel:R23-11#9edf14a62026-10-14
R24-11rel:R24-11#4f3e23582026-10-14
R25-11rel:R25-11#457a8c692026-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

फ़ंक्शन FileStorage [SWS_PER_00460] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00129, RS_AP_00146

FileStorage ()=delete;

The default constructor for FileStorage shall not be used.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage

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

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

Status: valid/unmigrated Version: rel:R25-11#11aa6301 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_00460@rel:R25-11#11aa6301

Recorded Revisions (6):

R25-11rel:R25-11#9eb415912026-09-30
R21-11rel:R21-11#f93f78842026-10-14
R22-11rel:R22-11#1e2c76302026-10-14
R23-11rel:R23-11#dd525b8f2026-10-14
R24-11rel:R24-11#11aa63012026-10-14
R25-11rel:R25-11#11aa63012026-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

फ़ंक्शन GetAllFileNames [SWS_PER_00110] Upstream: RS_PER_00001, RS_PER_00004, 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 > > GetAllFile Names () const noexcept;

Returns a list of all currently available file names of this File Storage. The list of file names is only accurate if no file is added or deleted at the same time.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage
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 file names. 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_00110
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00110@rel:R25-11#bc760aa8
Content hash: bc760aa8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00110

Status: valid/unmigrated Version: rel:R25-11#2a355aef 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_00110@rel:R25-11#2a355aef

Recorded Revisions (8):

R25-11rel:R25-11#2ea4c0b72026-09-30
R19-11rel:R19-11#2c8803ba2026-10-14
R20-11rel:R20-11#6c4ecd642026-10-14
R21-11rel:R21-11#7a8244992026-10-14
R22-11rel:R22-11#1e3bc0af2026-10-14
R23-11rel:R23-11#0cb5785b2026-10-14
R24-11rel:R24-11#2a355aef2026-10-14
R25-11rel:R25-11#2a355aef2026-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

फ़ंक्शन GetCurrentFileSize [SWS_PER_00407] 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 > GetCurrentFileSize (ara::core::StringView fileName) const noexcept;

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
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::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File Storage.

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

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

Status: valid/unmigrated Version: rel:R25-11#179f149b 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_00407@rel:R25-11#179f149b

Recorded Revisions (8):

R25-11rel:R25-11#071859e92026-09-30
R19-11rel:R19-11#033eba912026-10-14
R20-11rel:R20-11#3966ef4c2026-10-14
R21-11rel:R21-11#d10d2b0b2026-10-14
R22-11rel:R22-11#8dd5feab2026-10-14
R23-11rel:R23-11#9f29c68f2026-10-14
R24-11rel:R24-11#179f149b2026-10-14
R25-11rel:R25-11#179f149b2026-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

फ़ंक्शन GetFileInfo [SWS_PER_00438] Upstream: RS_PER_00004, 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< FileInfo > GetFileInfo (ara::core::StringView file Name) const noexcept;

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
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::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File Storage.

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

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

Status: valid/unmigrated Version: rel:R25-11#ac6ae9db 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_00438@rel:R25-11#ac6ae9db

Recorded Revisions (7):

R25-11rel:R25-11#54615ca12026-09-30
R20-11rel:R20-11#3e42a8462026-10-14
R21-11rel:R21-11#2ca508bf2026-10-14
R22-11rel:R22-11#374465322026-10-14
R23-11rel:R23-11#57dca30b2026-10-14
R24-11rel:R24-11#87296ea62026-10-14
R25-11rel:R25-11#ac6ae9db2026-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

फ़ंक्शन OpenFileReadOnly [SWS_PER_00114] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< ReadAccessor > > OpenFileReadOnly (ara::core::StringView fileName, OpenMode mode) noexcept;

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: b7f6df93c4d9 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage की विधि OpenFileReadOnly (#include "ara/per/file_storage.h" में घोषित) एक निर्दिष्ट एक्सेस मोड [SWS_PER_00114] के साथ किसी पर्सिस्टेड फ़ाइल को रीड-ओनली रूप में खोलती है। जब तक कि पैरामीटर mode के माध्यम से अन्यथा निर्दिष्ट न किया गया हो, रीड पॉइंटर की स्थिति डिफ़ॉल्ट रूप से फ़ाइल की शुरुआत (kAtTheBeginning) पर सेट होती है [SWS_PER_00114]। निष्पादन सिंक्रोनस रूप से होता है और एक ara::core::Result<UniqueHandle<ReadAccessor>> लौटाता है। हैंडल RAII सिमेंटिक्स का उपयोग करता है: जैसे ही UniqueHandle का इंस्टेंस अपने स्कोप से बाहर निकलता है, फ़ाइल स्वचालित रूप से बंद हो जाती है [SWS_PER_00114]।

समवर्तीता के संबंध में, विधि को thread-safe और exception safe (noexcept के साथ) के रूप में निर्दिष्ट किया गया है [SWS_PER_00114]। फिर भी, कार्यात्मक कॉल प्रतिबंध लागू होते हैं: यदि लक्षित फ़ाइल पहले से खुली है या उसी फ़ाइल नाम के साथ DeleteFile, RecoverFile या ResetFile जैसे ऑपरेशन एक साथ निष्पादित किए जा रहे हैं, तो कॉल PerErrc::kResourceBusy के साथ विफल हो जाता है [SWS_PER_00114]।

त्रुटि के मामले में, ara::core::Result निर्माता-विशिष्ट त्रुटियाँ या PerErrc अथवा StorageFailure से मानकीकृत त्रुटि कोड लौटाता है [SWS_PER_00114]:

PerErrc::kFileNotFound: निर्दिष्ट फ़ाइल, फ़ाइल स्टोरेज में मौजूद नहीं है [SWS_PER_00114]।
PerErrc::kInvalidOpenMode: पास किए गए मोड में फ़्लैग्स का एक अमान्य संयोजन शामिल है [SWS_PER_00114]।
StorageFailure: भौतिक स्टोरेज तक पहुँच विफल रही [SWS_PER_00114]।
PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kAuthenticationFailed या PerErrc::kEncryptionFailed: संरचनात्मक अखंडता क्षतिग्रस्त, सत्यापन अपर्याप्त, MAC जाँच त्रुटिपूर्ण या डिक्रिप्शन विफल रहा [SWS_PER_00114]।

अन्य इंटरफेस के साथ परस्पर क्रिया में, FileStorage दो संबंधित ओवरलोड प्रदान करता है: बिना मोड पैरामीटर वाला एक वेरिएंट, जो हमेशा फ़ाइल की शुरुआत में खुलता है [SWS_PER_00376], साथ ही बफ़र (ara::core::Span<ara::core::Byte> buffer) के साथ एक ओवरलोड, जिसके माध्यम से ReadAccessor कई छोटे एक्सेस को तेज़ करने के लिए ब्लॉक-वार रीडिंग लागू करता है [SWS_PER_00430]।

यह उपयोग नोट AUTOSAR Adaptive R25-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.
mode	Mode with which the file shall be opened.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< ReadAccessor > >	A Result containing a UniqueHandle for the file. 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File Storage.
PerErrc::kInvalidOpenMode	rollback_semantics Returned if the passed mode contains an invalid combination of modes.
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_00114
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00114@rel:R25-11#31f7102b
Content hash: 31f7102b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00114

Status: valid/unmigrated Version: rel:R25-11#d387e566 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_00114@rel:R25-11#d387e566

Recorded Revisions (8):

R25-11rel:R25-11#56472e6d2026-09-30
R19-11rel:R19-11#68c3cec42026-10-14
R20-11rel:R20-11#70976e3f2026-10-14
R21-11rel:R21-11#2c5ff8412026-10-14
R22-11rel:R22-11#2b3b319d2026-10-14
R23-11rel:R23-11#e52382f02026-10-14
R24-11rel:R24-11#f80914872026-10-14
R25-11rel:R25-11#d387e5662026-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

फ़ंक्शन OpenFileReadOnly [SWS_PER_00376] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< ReadAccessor > > OpenFileReadOnly (ara::core::StringView fileName) noexcept;

Opens a file of this File Storage for reading. The file is opened with the seek position set to the beginning (corresponding to kAtThe Beginning). The file will be closed when the returned UniqueHandle goes out of scope.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 4286b0e81322 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::per::FileStorage का मेथड OpenFileReadOnly किसी पर्सिस्टेड फ़ाइल को पढ़ने के लिए केवल-पढ़ने (read-only) मोड में खोलता है [SWS_PER_00376]। कॉल हेडर फ़ाइल ara/per/file_storage.h के माध्यम से फ़ाइल नाम fileName पास करके की जाती है। पठन स्थिति (read position) आरंभ में फ़ाइल के आरंभ पर सेट की जाती है। रिटर्न मान के रूप में ara::core::Result कार्य करता है, जो सफलता पर UniqueHandle<ReadAccessor> प्रदान करता है। खोली गई फ़ाइल स्वचालित रूप से बंद हो जाती है जैसे ही यह हैंडल अपने स्कोप से बाहर निकल जाता है।

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

यदि निष्पादन विफल हो जाता है, तो परिणाम में एक त्रुटि कोड या निर्माता-विशिष्ट त्रुटि शामिल होती है [SWS_PER_00376]:

PerErrc::kFileNotFound: निर्दिष्ट फ़ाइल स्टोरेज में मौजूद नहीं है।
PerErrc::kResourceBusy: फ़ाइल पहले से खुली है या DeleteFile, RecoverFile या ResetFile द्वारा एक ही समय में संसाधित की जा रही है।
PerErrc::kPhysicalStorageFailure: भौतिक स्टोरेज माध्यम तक एक्सेस विफल हो गया है।
PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed, PerErrc::kAuthenticationFailed: संरचना अखंडता, डेटा सत्यापन, डिक्रिप्शन या MAC सत्यापन में त्रुटियाँ।

समवर्तीता और परस्पर क्रिया

इस मेथड को thread-safe, exception safe तथा noexcept के रूप में निर्दिष्ट किया गया है [SWS_PER_00376]। उन्नत आवश्यकताओं के लिए ओवरलोड उपलब्ध हैं: स्पष्ट रूप से OpenMode निर्दिष्ट करने के लिए एक संस्करण [SWS_PER_00114] और साथ ही छोटे पठन अभिगमनों (read accesses) को ब्लॉक-वार तेज़ करने के लिए अतिरिक्त उपयोगकर्ता बफ़र के साथ एक हस्ताक्षर [SWS_PER_00430]।

यह उपयोग संबंधी नोट AUTOSAR विनिर्देश के आधार पर स्वचालित रूप से तैयार किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< ReadAccessor > >	A Result containing a UniqueHandle for the file. 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File Storage.
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_00376
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00376@rel:R25-11#8ee5fa40
Content hash: 8ee5fa40
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00376

Status: valid/unmigrated Version: rel:R25-11#c1cc1c73 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_00376@rel:R25-11#c1cc1c73

Recorded Revisions (8):

R25-11rel:R25-11#f25323df2026-09-30
R19-11rel:R19-11#630d35ad2026-10-14
R20-11rel:R20-11#c212e2fc2026-10-14
R21-11rel:R21-11#d617d2d22026-10-14
R22-11rel:R22-11#88f516892026-10-14
R23-11rel:R23-11#eab160e12026-10-14
R24-11rel:R24-11#6b07bd902026-10-14
R25-11rel:R25-11#c1cc1c732026-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

फ़ंक्शन OpenFileReadOnly [SWS_PER_00430] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< ReadAccessor > > OpenFileReadOnly (ara::core::StringView fileName, OpenMode mode, ara::core::Span< ara::core::Byte > buffer) noexcept;

Opens a file of this File Storage for reading with a user provided buffer. If not otherwise specified by the provided mode, the file is opened with the seek position set to the beginning (corresponding to kAtTheBeginning). The provided buffer will be used by the ReadAccessor to implement block-wise reading to speed up multiple small accesses to the file. The file will be closed when the returned UniqueHandle goes out of scope.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: f3a0884b9d84 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage का सिंक्रोनस मेथड OpenFileReadOnly कॉलर द्वारा प्रदान किए गए बफ़र का उपयोग करके पठन एक्सेस के लिए एक पर्सिस्टेड फ़ाइल खोलता है [SWS_PER_00430]। पैरामीटर fileName, mode तथा buffer (ara::core::Span<ara::core::Byte> के रूप में) के आधार पर फ़ाइल एक्सेस प्रारंभ किया जाता है [SWS_PER_00430]। जब तक mode के माध्यम से अन्यथा निर्दिष्ट न किया गया हो, पठन स्थिति डिफ़ॉल्ट रूप से फ़ाइल के प्रारंभ (kAtTheBeginning) पर होती है [SWS_PER_00430]। पास किए गए मेमोरी क्षेत्र का उपयोग परिणामी ReadAccessor द्वारा ब्लॉक-वार पढ़ने के माध्यम से बार-बार होने वाले छोटे पठन अभिगमनों को तेज़ करने के लिए किया जाता है [SWS_PER_00430]। यह संसाधन RAII के माध्यम से सुरक्षित है: जैसे ही लौटाया गया UniqueHandle स्कोप से बाहर निकल जाता है, फ़ाइल स्वचालित रूप से बंद हो जाती है [SWS_PER_00430]।

समवर्तीता के संदर्भ में, फ़ंक्शन को थ्रेड-सुरक्षित (thread-safe), अपवाद-सुरक्षित (exception safe) और noexcept के रूप में निर्दिष्ट किया गया है [SWS_PER_00430]। यदि कोई त्रुटि उत्पन्न होती है, तो ara::core::Result निर्माता-विशिष्ट त्रुटियाँ या PerErrc से मानकीकृत त्रुटि कोड प्रदान करता है [SWS_PER_00430]:

PerErrc::kResourceBusy: फ़ाइल पहले से खुली है या DeleteFile, RecoverFile या ResetFile द्वारा एक ही समय में संसाधित की जा रही है [SWS_PER_00430]।
PerErrc::kFileNotFound: निर्दिष्ट फ़ाइल, फ़ाइल स्टोरेज में मौजूद नहीं है [SWS_PER_00430]।
PerErrc::kInvalidOpenMode: पास किए गए मोड में विकल्पों का एक अमान्य संयोजन शामिल है [SWS_PER_00430]।
अखंडता और सुरक्षा त्रुटियाँ: PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed (MAC जाँच की विफलता) और साथ ही भौतिक स्टोरेज एक्सेस त्रुटियों के मामले में StorageFailure [SWS_PER_00430]।

इस बफ़र किए गए संस्करण के अतिरिक्त, उपयोगकर्ता-परिभाषित बफ़र के बिना उपयोग के मामलों के लिए ओवरलोड [SWS_PER_00114] (mode के साथ) और [SWS_PER_00376] (केवल fileName के साथ) उपलब्ध हैं।

यह उपयोग संबंधी निर्देश AUTOSAR R25-11 विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.
mode	Mode with which the file shall be opened.
buffer	Memory to be used for block-wise reading.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< ReadAccessor > >	A Result containing a UniqueHandle for the file. 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File Storage.
PerErrc::kInvalidOpenMode	rollback_semantics Returned if the passed mode contains an invalid combination of modes.
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_00430
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00430@rel:R25-11#c2433a4b
Content hash: c2433a4b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00430

Status: valid/unmigrated Version: rel:R25-11#6f001bfd 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_00430@rel:R25-11#6f001bfd

Recorded Revisions (7):

R25-11rel:R25-11#d5ddc0d92026-09-30
R20-11rel:R20-11#a9e488522026-10-14
R21-11rel:R21-11#f7bf78f42026-10-14
R22-11rel:R22-11#668067d82026-10-14
R23-11rel:R23-11#bc8680862026-10-14
R24-11rel:R24-11#062cbdd82026-10-14
R25-11rel:R25-11#6f001bfd2026-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

फ़ंक्शन OpenFileReadWrite [SWS_PER_00113] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< ReadWriteAccessor > > OpenFileRead Write (ara::core::StringView fileName, OpenMode mode) noexcept;

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: cf05039b8020 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::per::FileStorage का सिंक्रोनस मेथड OpenFileReadWrite निर्दिष्ट मोड mode [SWS_PER_00113] में रीड और राइट एक्सेस के लिए एक फ़ाइल खोलता है। यदि मोड में अन्यथा निर्दिष्ट न हो, तो फ़ाइल पॉइंटर डिफ़ॉल्ट रूप से शुरुआत में सेट किया जाता है (kAtTheBeginning)। यदि फ़ाइल अभी तक मौजूद नहीं है, तो यह स्वचालित रूप से बनाई जाती है [SWS_PER_00113]। फ़ंक्शन UniqueHandle<ReadWriteAccessor> के साथ एक ara::core::Result लौटाता है, जो हैंडल के अपने स्कोप से बाहर जाते ही फ़ाइल को स्वचालित रूप से बंद कर देता है [SWS_PER_00113]।

समवर्तीता और प्रतिबंध

कॉल थ्रेड-सुरक्षित (thread-safe) है और कोई अपवाद नहीं फेंकता है (noexcept) [SWS_PER_00113]। कॉल के समय फ़ाइल पहले से खुली नहीं होनी चाहिए। इसके अलावा, समान फ़ाइल नाम के साथ DeleteFile, RecoverFile या ResetFile का कोई एक साथ निष्पादन नहीं होना चाहिए, अन्यथा कॉल PerErrc::kResourceBusy के साथ विफल हो जाएगी [SWS_PER_00113]।

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

त्रुटि की स्थिति में, ara::core::Result में विशिष्ट एरर कोड होते हैं [SWS_PER_00113]:

PerErrc::kInvalidOpenMode: पास किए गए mode में फ़्लैग्स का अमान्य संयोजन।
PerErrc::kResourceBusy: लक्षित फ़ाइल पहले से खुली है या प्रशासनिक फ़ाइल संचालन द्वारा अधिग्रहित है।
Access: स्टोरेज को केवल-पढ़ने के लिए कॉन्फ़िगर किया गया है या पहले से मौजूद कुंजी के मामले में write-only-once के रूप में कॉन्फ़िगर किया गया है।
PerErrc::kOutOfStorageSpace या PerErrc::kTooManyFiles: नई फ़ाइल बनाते समय अपर्याप्त भौतिक संग्रहण स्थान या maxNumberOfFiles का उल्लंघन।
PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed, PerErrc::kAuthenticationFailed: हार्डवेयर एक्सेस त्रुटियाँ, दूषित डेटा संरचनाएं या विफल क्रिप्टोग्राफ़िक सत्यापन।

इंटरैक्शन

सरलीकृत संस्करण के रूप में, बिना मोड पैरामीटर वाला एक ओवरलोड उपलब्ध है, जो फ़ाइलों को डिफ़ॉल्ट रूप से शुरुआत में खोलता है [SWS_PER_00375]। कई छोटे एक्सेसों के मामले में प्रदर्शन अनुकूलन के लिए, ब्लॉक-वाइज पढ़ने और लिखने के लिए उपयोगकर्ता-परिभाषित बफर (buffer) के साथ एक ओवरलोड भी मौजूद है [SWS_PER_00429]।

यह उपयोग नोट AUTOSAR Adaptive Release R25-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.
mode	Mode with which the file shall be opened.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< ReadWriteAccessor > >	A Result containing a UniqueHandle for the file. 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 File 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 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for a new file.
PerErrc::kInvalidOpenMode	rollback_semantics Returned if the passed mode contains an invalid combination of modes.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is created.
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_00113
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00113@rel:R25-11#8f5c0a8b
Content hash: 8f5c0a8b
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00113

Status: valid/unmigrated Version: rel:R25-11#64fa2a80 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_00113@rel:R25-11#64fa2a80

Recorded Revisions (8):

R25-11rel:R25-11#b7812ac62026-09-30
R19-11rel:R19-11#29f193992026-10-14
R20-11rel:R20-11#705aebbc2026-10-14
R21-11rel:R21-11#3e1bef852026-10-14
R22-11rel:R22-11#8b90a8c62026-10-14
R23-11rel:R23-11#9d0c90192026-10-14
R24-11rel:R24-11#c88f05782026-10-14
R25-11rel:R25-11#64fa2a802026-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

फ़ंक्शन OpenFileReadWrite [SWS_PER_00375] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< ReadWriteAccessor > > OpenFileRead Write (ara::core::StringView fileName) noexcept;

Opens a file of this File Storage for reading and writing. The file is opened with the seek position set to the beginning (corresponding to kAtThe Beginning). If the file does not exist, it is created. The file will be closed when the returned UniqueHandle goes out of scope.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: e0c7dc90877b उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

वर्ग ara::per::FileStorage का सिंक्रोनस सदस्य फलन OpenFileReadWrite संयुक्त पढ़ने और लिखने के एक्सेस के लिए फ़ाइल खोलने का कार्य करता है [SWS_PER_00375]। फ़ाइल नाम fileName को ara::core::StringView के रूप में पास किया जाता है, जो किसी कॉन्फ़िगर की गई फ़ाइल के मॉडलिंग PersistencyFile.fileName के अनुरूप हो सकता है [SWS_PER_00375]। यदि निर्दिष्ट फ़ाइल अभी तक मौजूद नहीं है, तो यह स्वचालित रूप से नई बनाई जाती है [SWS_PER_00375]। खोलते समय, फ़ाइल स्थिति तुरंत शुरुआत में सेट कर दी जाती है (kAtTheBeginning के अनुसार) [SWS_PER_00375]। कॉलर को एक ara::core::Result<UniqueHandle<ReadWriteAccessor>> प्राप्त होता है; जैसे ही लौटाया गया UniqueHandle अपने स्कोप से बाहर निकलता है, फ़ाइल स्वचालित रूप से बंद हो जाती है [SWS_PER_00375]।

समवर्तीता और निष्पादन संदर्भ के संबंध में, फलन को thread-safe और exception safe के रूप में निर्दिष्ट किया गया है [SWS_PER_00375]। हालाँकि, यह ध्यान दिया जाना चाहिए कि एक साथ एक्सेस विनियमित हैं: यदि फ़ाइल पहले से खुली है या उसी फ़ाइल नाम पर DeleteFile, RecoverFile या ResetFile जैसा कोई ऑपरेशन एक ही समय में निष्पादित किया जा रहा है, तो कॉल विफल हो जाती है और त्रुटि कोड PerErrc::kResourceBusy लौटाती है [SWS_PER_00375]।

त्रुटि की स्थिति में, लौटाया गया Result ऑब्जेक्ट पर्सिस्टेंस की विशिष्ट त्रुटियों या विक्रेता-विशिष्ट त्रुटियों को समाहित करता है [SWS_PER_00375]:

कॉन्फ़िगरेशन और एक्सेस त्रुटियाँ जैसे राइट-प्रोटेक्टेड मेमोरी के मामले में Access या Write-Once कॉन्फ़िगरेशन में पहले से मौजूद डेटा [SWS_PER_00375]।
कॉन्फ़िगर की गई फ़ाइल ऊपरी सीमा पार होने पर PerErrc::kOutOfStorageSpace या PerErrc::kTooManyFiles द्वारा संग्रहण स्थान सीमाएं [SWS_PER_00375]।
अखंडता और सुरक्षा त्रुटियाँ जैसे PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed [SWS_PER_00375]।

FileStorage के अन्य इंटरफ़ेस के साथ परस्पर क्रिया में, AUTOSAR वैकल्पिक ओवरलोड प्रदान करता है: OpenFileReadWrite को स्पष्ट OpenMode के साथ कॉल किया जा सकता है [SWS_PER_00113] या अतिरिक्त उपयोगकर्ता-साइड मेमोरी क्षेत्र buffer (ara::core::Span<ara::core::Byte>) के साथ, जो बार-बार होने वाले छोटे एक्सेस को गति देने के लिए ब्लॉक-वार बफरिंग सक्षम बनाता है [SWS_PER_00429]।

यह पाठ एक AI द्वारा जनरेट किया गया था और AUTOSAR विनिर्देश के आधार पर सत्यापित किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< ReadWriteAccessor > >	A Result containing a UniqueHandle for the file. 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 File 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 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for a new file.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is created.
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_00375
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00375@rel:R25-11#aa852a0f
Content hash: aa852a0f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00375

Status: valid/unmigrated Version: rel:R25-11#f465ec05 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_00375@rel:R25-11#f465ec05

Recorded Revisions (8):

R25-11rel:R25-11#ff96f9722026-09-30
R19-11rel:R19-11#cc81c63c2026-10-14
R20-11rel:R20-11#1cfd91622026-10-14
R21-11rel:R21-11#32976f732026-10-14
R22-11rel:R22-11#8a4213d62026-10-14
R23-11rel:R23-11#c423d7112026-10-14
R24-11rel:R24-11#0b6d7d9b2026-10-14
R25-11rel:R25-11#f465ec052026-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

फ़ंक्शन OpenFileReadWrite [SWS_PER_00429] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< ReadWriteAccessor > > OpenFileRead Write (ara::core::StringView fileName, OpenMode mode, ara::core::Span< ara::core::Byte > buffer) noexcept;

Opens a file of this File Storage for reading and writing with a user provided buffer. If not otherwise specified by the provided mode, the file is opened with the seek position set to the beginning (corresponding to kAtTheBeginning). The provided buffer will be used by the ReadWriteAccessor to implement block-wise reading and writing to speed up multiple small accesses to the file. If the file does not exist, it is created. The file will be closed when the returned UniqueHandle goes out of scope.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 06577277e905 उद्गम खुले प्रश्न (1)

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::per::FileStorage का मेथड OpenFileReadWrite उपयोगकर्ता-परिभाषित बफ़र प्रदान करके संयुक्त रूप से पढ़ने और लिखने के लिए तुल्यकालिक रूप से फ़ाइल खोलता है [SWS_PER_00429]। पास किए गए मेमोरी क्षेत्र buffer (ara::core::Span<ara::core::Byte> के रूप में) का उपयोग आंतरिक रूप से ReadWriteAccessor द्वारा ब्लॉक-वार पठन और लेखन ऑपरेशनों के लिए किया जाता है, ताकि छोटे एक्सेस की श्रृंखलाओं को उच्च प्रदर्शन के साथ संसाधित किया जा सके। यदि निर्दिष्ट फ़ाइल अभी तक मौजूद नहीं है, तो यह स्वचालित रूप से नई बनाई जाती है; फ़ाइल की स्थिति डिफ़ॉल्ट रूप से शुरुआत (kAtTheBeginning) पर होती है, जब तक कि पास किए गए mode में अन्यथा निर्दिष्ट न किया गया हो [SWS_PER_00429]। जैसे ही ara::core::Result में लौटाया गया UniqueHandle अपने स्कोप से बाहर निकल जाता है, फ़ाइल बंद हो जाती है। व्याख्या: पास किए गए बफ़र-स्पैन की अंतर्निहित मेमोरी संभवतः UniqueHandle के संपूर्ण जीवनकाल के लिए मान्य रहनी चाहिए, क्योंकि एक्सेसर ब्लॉक एक्सेस के लिए इसे संदर्भित करता है। प्रश्न Q-e0009b7de17e3597 (खुला)

त्रुटि हैंडलिंग और समवर्तीता

फ़ंक्शन को noexcept, अपवाद-सुरक्षित (exception safe) और थ्रेड-सुरक्षित निर्दिष्ट किया गया है [SWS_PER_00429]। विफलताओं के मामले में, Result निर्माता-विशिष्ट त्रुटियाँ या परिभाषित त्रुटि कोड प्रदान करता है:

PerErrc::kResourceBusy: फ़ाइल पहले से खुली है या उसी नाम के साथ DeleteFile, RecoverFile या ResetFile द्वारा एक ही समय में संसाधित की जा रही है [SWS_PER_00429]।
Access: मेमोरी क्षेत्र केवल-पढ़ने (read-only) के रूप में कॉन्फ़िगर किया गया है या केवल-एक-बार-लिखने (write-only-once) के रूप में निर्धारित है और पहले से ही भरा हुआ है [SWS_PER_00429]।
PerErrc::kInvalidOpenMode: पास किए गए mode में अमान्य विशेषता संयोजन शामिल है [SWS_PER_00429]।
PerErrc::kOutOfStorageSpace या PerErrc::kTooManyFiles: भौतिक मेमोरी नए निर्माण के लिए पर्याप्त नहीं है या कॉन्फ़िगर की गई सीमा maxNumberOfFiles पार हो जाएगी [SWS_PER_00429]।
PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed और PerErrc::kAuthenticationFailed: एक्सेस, अखंडता, MAC या सत्यापन जाँच के साथ-साथ डिक्रिप्शन में त्रुटियाँ [SWS_PER_00429]।

इंटरैक्शन

यह मेथड पढ़ने/लिखने के लिए खोलने का एक प्रदर्शन-अनुकूलित संस्करण प्रस्तुत करता है: जबकि [SWS_PER_00113] केवल फ़ाइल नाम और मोड को और [SWS_PER_00375] विशेष रूप से केवल फ़ाइल नाम को संसाधित करता है, [SWS_PER_00429] एक स्पष्ट मेमोरी बफ़र के माध्यम से छोटे I/O एक्सेस को लक्षित रूप से तेज़ करने की अनुमति देता है।

यह पाठ AI द्वारा तैयार किया गया था और AUTOSAR विनिर्देश के दिशानिर्देशों पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.
mode	Mode with which the file shall be opened.
buffer	Memory to be used for block-wise reading/writing.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< ReadWriteAccessor > >	A Result containing a UniqueHandle for the file. 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 File 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 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for a new file.
PerErrc::kInvalidOpenMode	rollback_semantics Returned if the passed mode contains an invalid combination of modes.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is created.
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_00429
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00429@rel:R25-11#9bfbd17f
Content hash: 9bfbd17f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00429

Status: valid/unmigrated Version: rel:R25-11#e9dd40b8 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_00429@rel:R25-11#e9dd40b8

Recorded Revisions (7):

R25-11rel:R25-11#380d9a532026-09-30
R20-11rel:R20-11#38b6d4692026-10-14
R21-11rel:R21-11#a276c7642026-10-14
R22-11rel:R22-11#359642092026-10-14
R23-11rel:R23-11#09bac95b2026-10-14
R24-11rel:R24-11#7891475a2026-10-14
R25-11rel:R25-11#e9dd40b82026-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

फ़ंक्शन OpenFileWriteOnly [SWS_PER_00115] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< WriteAccessor > > OpenFileWriteOnly (ara::core::StringView fileName, OpenMode mode) noexcept;

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: cf72b60c71fb उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

वर्ग ara::per::FileStorage की विधि OpenFileWriteOnly परिभाषित एक्सेस मोड के साथ विशेष लेखन के लिए फ़ाइल को सिंक्रोनस रूप से खोलती है [SWS_PER_00115]। जब तक पैरामीटर mode के माध्यम से अन्यथा निर्दिष्ट न किया गया हो, फ़ाइल को ट्रंकेट किया जाता है (kTruncate के अनुसार)। यदि फ़ाइल पहले से मौजूद नहीं है, तो इसे नया बनाया जाता है। वापसी मान के रूप में एक ara::core::Result<UniqueHandle<WriteAccessor>> कार्य करता है; UniqueHandle के स्कोप से बाहर निकलते समय फ़ाइल स्वचालित रूप से पुनः बंद हो जाती है [SWS_PER_00115]।

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

त्रुटि की स्थिति में, लौटाए गए Result में विशिष्ट त्रुटि कोड शामिल होते हैं [SWS_PER_00115]: Access इंगित करता है कि स्टोरेज राइट-प्रोटेक्टेड है या Write-Once के रूप में कॉन्फ़िगर किया गया है और कुंजी पहले से मौजूद है। PerErrc::kInvalidOpenMode अमान्य मोड संयोजनों की रिपोर्ट करता है और PerErrc::kOutOfStorageSpace अपर्याप्त भौतिक संग्रहण स्थान की। इसके अतिरिक्त, PerErrc::kTooManyFiles, PerErrc::kPhysicalStorageFailure और साथ ही अखंडता तथा सुरक्षा त्रुटियाँ जैसे PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed हो सकती हैं [SWS_PER_00115]।

समवर्तीता और प्रतिबंध

फलन को थ्रेड-सुरक्षित और अपवाद-सुरक्षित (noexcept) डिज़ाइन किया गया है [SWS_PER_00115]। उसी फ़ाइल पर समानांतर एक्सेस त्रुटि कोड PerErrc::kResourceBusy के साथ विफल हो जाती है यदि फ़ाइल पहले से खुली है या उसी फ़ाइल नाम के साथ DeleteFile, RecoverFile या ResetFile जैसे ऑपरेशन एक ही समय में निष्पादित किए जा रहे हैं [SWS_PER_00115]।

इंटरैक्शन

इस फलन के अलावा, इंटरफ़ेस बिना मोड पैरामीटर के एक सरलीकृत ओवरलोड प्रदान करता है, जो डिफ़ॉल्ट रूप से kTruncate के साथ काम करता है [SWS_PER_00377], और कई छोटे एक्सेस को गति देने के लिए ब्लॉक-वार लेखन सक्षम करने हेतु उपयोगकर्ता-परिभाषित बफर के साथ एक ओवरलोड प्रदान करता है [SWS_PER_00431]।

यह उपयोग नोट विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.
mode	Mode with which the file shall be opened.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< WriteAccessor > >	A Result containing a UniqueHandle for the file. 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 File 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 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for a new file.
PerErrc::kInvalidOpenMode	rollback_semantics Returned if the passed mode contains an invalid combination of modes.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is created.
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_00115
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00115@rel:R25-11#7471025f
Content hash: 7471025f
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00115

Status: valid/unmigrated Version: rel:R25-11#8d570d7b 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_00115@rel:R25-11#8d570d7b

Recorded Revisions (8):

R25-11rel:R25-11#947090352026-09-30
R19-11rel:R19-11#a8c3f2cb2026-10-14
R20-11rel:R20-11#a4a01e002026-10-14
R21-11rel:R21-11#9d4cb3182026-10-14
R22-11rel:R22-11#94711d402026-10-14
R23-11rel:R23-11#e0aa47d82026-10-14
R24-11rel:R24-11#6c8c32a92026-10-14
R25-11rel:R25-11#8d570d7b2026-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

फ़ंक्शन OpenFileWriteOnly [SWS_PER_00377] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< WriteAccessor > > OpenFileWriteOnly (ara::core::StringView fileName) noexcept;

Opens a file of this File Storage for writing. The file is truncated (corresponding to kTruncate). If the file does not exist, it is created. The file will be closed when the returned UniqueHandle goes out of scope.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: fa6d3b80cd05 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::per::FileStorage का सिंक्रोनस मेथड OpenFileWriteOnly [SWS_PER_00377] के अनुसार केवल लिखने के लिए एक फ़ाइल खोलता है। यह पैरामीटर fileName के माध्यम से लक्षित फ़ाइल का नाम लेता है। यदि फ़ाइल मौजूद नहीं है, तो इसे नया बनाया जाता है; पहले से मौजूद फ़ाइल को छोटा (कटा हुआ, kTruncate के अनुसार) कर दिया जाता है [SWS_PER_00377]। रिटर्न मान के रूप में ara::core::Result कार्य करता है, जो सफलता पर ara::per::UniqueHandle<WriteAccessor> को समाहित करता है। यह हैंडल RAII पैटर्न के अनुसार फ़ाइल को स्वचालित रूप से बंद कर देता है जैसे ही यह स्कोप से बाहर निकल जाता है [SWS_PER_00377]।

त्रुटि हैंडलिंग और समवर्तीता

ऑपरेशन को noexcept के रूप में घोषित किया गया है, यह अपवाद-सुरक्षित और थ्रेड-सुरक्षित है [SWS_PER_00377]। त्रुटि की स्थिति में, Result में PerErrc से एक विशिष्ट त्रुटि कोड या निर्माता-विशिष्ट त्रुटि शामिल होती है [SWS_PER_00377]:

PerErrc::kResourceBusy: फ़ाइल पहले से खुली है या DeleteFile, RecoverFile या ResetFile द्वारा एक ही समय में संपादित की जा रही है।
PerErrc::kOutOfStorageSpace और PerErrc::kTooManyFiles: भौतिक मेमोरी अपर्याप्त है या कॉन्फ़िगर की गई फ़ाइलों की अधिकतम संख्या (maxNumberOfFiles) से अधिक हो जाती है।
PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed: हार्डवेयर एक्सेस के साथ-साथ अखंडता, सत्यापन या डिक्रिप्शन जाँच में त्रुटियाँ।

इंटरैक्शन

जबकि यह संस्करण ट्रंकेशन को दृढ़ता से पूर्वनिर्धारित करता है, पैरामीटर OpenMode वाला ओवरलोड एक भिन्न ओपनिंग मोड की अनुमति देता है [SWS_PER_00115]। कई छोटे एक्सेस वाले अनुकूलित, ब्लॉक-वार लेखन ऑपरेशनों के लिए, उपयोगकर्ता-परिभाषित बफ़र (ara::core::Span<ara::core::Byte>) के साथ एक अन्य ओवरलोड उपलब्ध है [SWS_PER_00431]।

यह पाठ AUTOSAR Adaptive R25-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< WriteAccessor > >	A Result containing a UniqueHandle for the file. 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 File 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 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for a new file.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is created.
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_00377
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00377@rel:R25-11#8da96810
Content hash: 8da96810
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00377

Status: valid/unmigrated Version: rel:R25-11#b93b741b 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_00377@rel:R25-11#b93b741b

Recorded Revisions (8):

R25-11rel:R25-11#425765882026-09-30
R19-11rel:R19-11#19dcafc12026-10-14
R20-11rel:R20-11#65cfdd922026-10-14
R21-11rel:R21-11#070ae0fe2026-10-14
R22-11rel:R22-11#8d2829d82026-10-14
R23-11rel:R23-11#f1d4f46e2026-10-14
R24-11rel:R24-11#06a2d0b72026-10-14
R25-11rel:R25-11#b93b741b2026-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

फ़ंक्शन OpenFileWriteOnly [SWS_PER_00431] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

ara::core::Result< UniqueHandle< WriteAccessor > > OpenFileWriteOnly (ara::core::StringView fileName, OpenMode mode, ara::core::Span< ara::core::Byte > buffer) noexcept;

Opens a file of this File Storage for writing with a user provided buffer. If not otherwise specified by the provided mode, the file is truncated (corresponding to k Truncate). The provided buffer will be used by the ReadWriteAccessor to implement block-wise writing to speed up multiple small accesses to the file. If the file does not exist, it is created. The file will be closed when the returned UniqueHandle goes out of scope.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 37dc6b2848d7 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage का सिंक्रोनस मेथड OpenFileWriteOnly विशेष रूप से लिखने के लिए एक फ़ाइल खोलता है और सफलता की स्थिति में ara::core::Result<UniqueHandle<WriteAccessor>> लौटाता है [SWS_PER_00431]। लौटाए गए UniqueHandle के स्कोप से बाहर निकलने पर, खोली गई फ़ाइल स्वचालित रूप से बंद हो जाती है [SWS_PER_00431]। यह कॉल फ़ाइल नाम fileName और एक्सेस मोड mode के अलावा एक उपयोगकर्ता-पक्षीय बफ़र buffer (ara::core::Span<ara::core::Byte> के रूप में) लेता है, जिसका उपयोग बार-बार होने वाले छोटे लेखन अभिगमनों को तेज़ करने के लिए ब्लॉक-वार लेखन हेतु किया जाता है [SWS_PER_00431]। यदि मोड में अन्यथा कॉन्फ़िगर नहीं किया गया है, तो खोलते समय फ़ाइल को छोटा (कटा हुआ, kTruncate के अनुसार) कर दिया जाता है; यदि यह अभी तक मौजूद नहीं है, तो इसे नया बनाया जाता है [SWS_PER_00431]।

समवर्तीता (concurrency) और सुरक्षा के संबंध में, विधि को thread-safe और exception safe के रूप में निर्दिष्ट किया गया है तथा noexcept के रूप में घोषित किया गया है [SWS_PER_00431]। हालाँकि, यदि फ़ाइल पहले से खुली है या उसी फ़ाइल नाम पर DeleteFile, RecoverFile या ResetFile जैसे प्रशासनिक परिचालन समकालिक रूप से निष्पादित किए जा रहे हैं, तो एक्सेस विफल हो जाता है [SWS_PER_00431]।

त्रुटि की स्थिति में, परिणाम में PerErrc से एक संगत त्रुटि कोड या एक निर्माता-विशिष्ट त्रुटि वापस की जाती है [SWS_PER_00431]:

PerErrc::kResourceBusy: फ़ाइल पहले से खुली है या किसी अन्य फ़ाइल परिचालन द्वारा व्यस्त है [SWS_PER_00431]।
PerErrc::kIllegalWriteAccess: File Storage राइट-प्रोटेक्टेड है या write-only-once के रूप में कॉन्फ़िगर किया गया है और फ़ाइल पहले से मौजूद है [SWS_PER_00431]।
PerErrc::kInvalidOpenMode: पास किया गया मोड संयोजन अमान्य है [SWS_PER_00431]।
PerErrc::kOutOfStorageSpace या PerErrc::kTooManyFiles: संग्रहण स्थान अपर्याप्त है या कॉन्फ़िगर की गई फ़ाइलों की अधिकतम संख्या पार हो गई है [SWS_PER_00431]।
PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed: भौतिक एक्सेस, अखंडता (integrity), सत्यापन (validation), डिक्रिप्शन या प्रमाणीकरण (authentication) में त्रुटि [SWS_PER_00431]।

अन्य इंटरफ़ेस के साथ परस्पर क्रिया में, यह फ़ंक्शन अनुकूलित राइट परिचालनों के लिए बफ़र समर्थन को लक्षित रूप से जोड़कर मूल विधियों [SWS_PER_00377] (केवल fileName) और [SWS_PER_00115] (mode के साथ) का विस्तार करता है [SWS_PER_00431]।

यह उपयोग नोट AUTOSAR R25-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.
mode	Mode with which the file shall be opened.
buffer	Memory to be used for block-wise writing.

Rückgabewert

Typ	Beschreibung
ara::core::Result<UniqueHandle< WriteAccessor > >	A Result containing a UniqueHandle for the file. 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 File 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 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::kResourceBusy	rollback_semantics Returned if the file is already open, or if DeleteFile, RecoverFile, or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for a new file.
PerErrc::kInvalidOpenMode	rollback_semantics Returned if the passed mode contains an invalid combination of modes.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is created.
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_00431
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00431@rel:R25-11#ec7b83fd
Content hash: ec7b83fd
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00431

Status: valid/unmigrated Version: rel:R25-11#3f1ccf51 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_00431@rel:R25-11#3f1ccf51

Recorded Revisions (7):

R25-11rel:R25-11#4a5239432026-09-30
R20-11rel:R20-11#cee86b4c2026-10-14
R21-11rel:R21-11#97f9954b2026-10-14
R22-11rel:R22-11#950e84fd2026-10-14
R23-11rel:R23-11#26aeb4402026-10-14
R24-11rel:R24-11#e7c640db2026-10-14
R25-11rel:R25-11#3f1ccf512026-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

फ़ंक्शन RecoverFile [SWS_PER_00337] Upstream: RS_PER_00001, RS_PER_00004, RS_PER_00009, 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 > RecoverFile (ara::core::StringView fileName) noexcept;

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 1adb8f07ad8e उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::per::FileStorage का सिंक्रोनस मेथड RecoverFile अतिरेक जाँच विफल होने पर एकल फ़ाइल की बेस्ट-एफ़र्ट पुनर्स्थापना करता है [SWS_PER_00337]। प्रभावित फ़ाइल का पहचानकर्ता पैरामीटर fileName के माध्यम से ara::core::StringView के रूप में पास किया जाता है। पुनर्स्थापना के बाद, फ़ाइल में पुराना डेटा या प्रारंभिक सामग्री हो सकती है, या सबसे खराब स्थिति में यह नष्ट हो सकती है [SWS_PER_00337]।

समवर्तीता और परस्पर क्रिया

ऑपरेशन को थ्रेड-सुरक्षित और अपवाद-सुरक्षित निर्दिष्ट किया गया है [SWS_PER_00337]। हालाँकि, इसे खुली हुई फ़ाइलों पर निष्पादित नहीं किया जाना चाहिए: कॉल करने से पहले, फ़ाइल खोलने के तरीकों जैसे [SWS_PER_00113], [SWS_PER_00114] या [SWS_PER_00375] के माध्यम से प्राप्त किए गए सभी UniqueHandle-इंस्टेंस बंद होने चाहिए [SWS_PER_00337]। अन्यथा कॉल PerErrc::kResourceBusy के साथ विफल हो जाता है। यही त्रुटि तब भी रिपोर्ट की जाती है जब उसी फ़ाइल नाम के लिए एक ही समय में [SWS_PER_00111] (DeleteFile) या [SWS_PER_00338] (ResetFile) निष्पादित किया जाता है [SWS_PER_00337]।

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

यह फ़ंक्शन ara::core::Result<void> लौटाता है [SWS_PER_00337]। PerErrc::kResourceBusy के अलावा, निम्नलिखित मानकीकृत त्रुटियाँ हो सकती हैं:

PerErrc::kFileNotFound: निर्दिष्ट फ़ाइल, फ़ाइल स्टोरेज में मौजूद नहीं है [SWS_PER_00337]।
PerErrc::kPhysicalStorageFailure: भौतिक स्टोरेज माध्यम तक एक्सेस विफल हो जाता है [SWS_PER_00337]।
PerErrc::kOutOfStorageSpace: उपलब्ध भौतिक संग्रहण स्थान पुनर्स्थापित फ़ाइल के लिए पर्याप्त नहीं है [SWS_PER_00337]।
PerErrc::kQuotaExceeded: पुनर्स्थापित फ़ाइल कॉन्फ़िगर की गई सीमा maximumAllowedSize से अधिक हो जाएगी [SWS_PER_00337]।
PerErrc::kEncryptionFailed और PerErrc::kAuthenticationFailed: संग्रहीत डेटा का क्रिप्टोग्राफ़िक डिक्रिप्शन या MAC सत्यापन विफल हो गया है [SWS_PER_00337]।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kPhysical no_rollback_semantics

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

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
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the encryption or decryption of stored data fails.
PerErrc::kResourceBusy	rollback_semantics Returned if the file is open, or if DeleteFile or ResetFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the recovered file.
PerErrc::kFileNotFound	rollback_semantics Returned if the provided file does not exist in the File Storage.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the recovered file would exceed the configured maximumAllowedSize of the File 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_00337
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00337@rel:R25-11#70471844
Content hash: 70471844
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00337

Status: valid/unmigrated Version: rel:R25-11#bc734b10 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_00337@rel:R25-11#bc734b10

Recorded Revisions (8):

R25-11rel:R25-11#197d86622026-09-30
R19-11rel:R19-11#c81267f62026-10-14
R20-11rel:R20-11#e1325f5e2026-10-14
R21-11rel:R21-11#7b0aeab52026-10-14
R22-11rel:R22-11#55f9192b2026-10-14
R23-11rel:R23-11#44af99602026-10-14
R24-11rel:R24-11#b7a26e732026-10-14
R25-11rel:R25-11#bc734b102026-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

फ़ंक्शन ResetFile [SWS_PER_00338] Upstream: RS_PER_00001, RS_PER_00004, RS_PER_00009, 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 > ResetFile (ara::core::StringView fileName) noexcept;

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 16bebc8c99d8 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

क्लास ara::per::FileStorage का सिंक्रोनस मेथड ResetFile किसी एकल फ़ाइल को उसकी पूर्व-कॉन्फ़िगर की गई प्रारंभिक स्थिति में रीसेट करता है [SWS_PER_00338]। यदि fileName के माध्यम से निर्दिष्ट फ़ाइल स्टोरेज में पहले से मौजूद नहीं है, तो इसे नया बनाया जाता है [SWS_PER_00338]। दोनों ही मामलों में, फ़ाइल में बाद में वही सामग्री होती है जो वर्तमान Target Configuration से नए इंस्टॉलेशन के बाद होती है [SWS_PER_00338]; इसकी परिवर्तन स्थिति FileModificationState में kModifiedDuringReset के रूप में प्रबंधित की जाती है [SWS_PER_00436]।

यह ऑपरेशन थ्रेड-सुरक्षित तथा अपवाद-सुरक्षित है और तुल्यकालिक रूप से ara::core::Result<void> लौटाता है [SWS_PER_00338]। यदि फ़ाइल वर्तमान में खुली है – उदाहरण के लिए [SWS_PER_00113] के माध्यम से – या उसी फ़ाइल नाम के साथ [SWS_PER_00111] या [SWS_PER_00337] का निष्पादन एक ही समय में हो रहा है, तो यह PerErrc::kResourceBusy के साथ विफल हो जाता है [SWS_PER_00338]।

इसके अलावा, इंटरफ़ेस विशिष्ट त्रुटि स्थितियों को परिभाषित करता है [SWS_PER_00338]:

PerErrc::kInitValueNotAvailable: न तो Application Design में और न ही Target Configuration में कोई प्रारंभिक मान कॉन्फ़िगर किया गया है [SWS_PER_00338]।
PerErrc::kQuotaExceeded या PerErrc::kTooManyFiles: पुनर्स्थापित फ़ाइल सीमा AllowedSize या maxNumberOfFiles से अधिक हो जाएगी [SWS_PER_00338]।
PerErrc::kOutOfStorageSpace या StorageFailure: भौतिक संग्रहण स्थान अपर्याप्त है या भौतिक एक्सेस विफल हो जाता है [SWS_PER_00338]।
PerErrc::kEncryptionFailed या PerErrc::kAuthenticationFailed: संग्रहीत डेटा का एन्क्रिप्शन या डिक्रिप्शन अथवा MAC सत्यापन विफल हो जाता है [SWS_PER_00338]।

यह उपयोग निर्देश AI द्वारा तैयार किया गया था और यह AUTOSAR Adaptive विनिर्देश R25-11 पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe PerErrc::kPhysical no_rollback_semantics

Parameter (in)

Parameter	Beschreibung
fileName	File name of the file. May correspond to the PersistencyFile.file Name of a configured file.

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
StorageFailure	Returned if access to the physical storage fails.
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 file.
PerErrc::kResourceBusy	rollback_semantics Returned if the file is open, or if DeleteFile or RecoverFile with the same file name is currently being executed.
PerErrc::kOutOfStorageSpace	no_rollback_semantics Returned if the available physical storage space is insufficient for the initial file.
PerErrc::kTooManyFiles	rollback_semantics Returned if the number of files would get larger than the configured maxNumberOfFiles when the file is restored.
PerErrc::kQuotaExceeded	rollback_semantics Returned if the initial file would exceed the configured maximum AllowedSize of the File 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_00338
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00338@rel:R25-11#562bd4a4
Content hash: 562bd4a4
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00338

Status: valid/unmigrated Version: rel:R25-11#0e854863 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_00338@rel:R25-11#0e854863

Recorded Revisions (8):

R25-11rel:R25-11#e0bc7dbf2026-09-30
R19-11rel:R19-11#374792432026-10-14
R20-11rel:R20-11#447c2e0a2026-10-14
R21-11rel:R21-11#3249eca82026-10-14
R22-11rel:R22-11#5318b4ac2026-10-14
R23-11rel:R23-11#7d4afee22026-10-14
R24-11rel:R24-11#e91250742026-10-14
R25-11rel:R25-11#0e8548632026-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_00327] Upstream: RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00145, RS_AP_00159

FileStorage & operator= (FileStorage &&fs)=delete;

The move assignment operator for FileStorage shall not be used.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage

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

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

Status: valid/unmigrated Version: rel:R25-11#cfa00f65 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_00327@rel:R25-11#cfa00f65

Recorded Revisions (8):

R25-11rel:R25-11#d0dd99c82026-09-30
R19-11rel:R19-11#c719ee8c2026-10-14
R20-11rel:R20-11#dbca66992026-10-14
R21-11rel:R21-11#b28a2eda2026-10-14
R22-11rel:R22-11#07630f652026-10-14
R23-11rel:R23-11#61a2cece2026-10-14
R24-11rel:R24-11#cfa00f652026-10-14
R25-11rel:R25-11#cfa00f652026-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_00329] Upstream: RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_AP_00145

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

The copy assignment operator for FileStorage shall not be used.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage

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

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

Status: valid/unmigrated Version: rel:R25-11#b7444c9a 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_00329@rel:R25-11#b7444c9a

Recorded Revisions (8):

R25-11rel:R25-11#24fb36102026-09-30
R19-11rel:R19-11#08d210462026-10-14
R20-11rel:R20-11#b39d46862026-10-14
R21-11rel:R21-11#b39d46862026-10-14
R22-11rel:R22-11#8e424eeb2026-10-14
R23-11rel:R23-11#9211a8ba2026-10-14
R24-11rel:R24-11#b7444c9a2026-10-14
R25-11rel:R25-11#b7444c9a2026-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

फ़ंक्शन ~FileStorage [SWS_PER_00330] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00129, RS_AP_00134, RS_AP_00145, RS_AP_00159

~FileStorage () noexcept;

Destructor for FileStorage.

Header-Datei	#include "ara/per/file_storage.h"
Scope	class ara::per::FileStorage
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_00330
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00330@rel:R25-11#bc07f53a
Content hash: bc07f53a
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00330

Status: valid/unmigrated Version: rel:R25-11#406daa83 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_00330@rel:R25-11#406daa83

Recorded Revisions (8):

R25-11rel:R25-11#a52467262026-09-30
R19-11rel:R19-11#f78017fc2026-10-14
R20-11rel:R20-11#0c5e9d812026-10-14
R21-11rel:R21-11#0c5e9d812026-10-14
R22-11rel:R22-11#888777422026-10-14
R23-11rel:R23-11#83343bdb2026-10-14
R24-11rel:R24-11#406daa832026-10-14
R25-11rel:R25-11#406daa832026-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::FileStorage

उपयोगकर्ता गाइडएआई जनित

संदर्भ

जीवनचक्र

उपयोग पथ

त्रुटि परिदृश्य

सदस्य मानचित्र

कंस्ट्रक्टर और डिस्ट्रक्टर

मेथड

ऑपरेटर

क्लास आरेख

विवरण दृश्य

कंस्ट्रक्टर और डिस्ट्रक्टर

मेथड

ऑपरेटर

मेथड का प्रलेखन

फ़ंक्शन DeleteFile [SWS_PER_00111] Upstream: RS_PER_00001, RS_PER_00004, 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 (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन FileExists [SWS_PER_00112] Upstream: RS_PER_00001, RS_PER_00004, 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:

फ़ंक्शन FileStorage [SWS_PER_00326] Upstream: RS_PER_00004, 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:

फ़ंक्शन FileStorage [SWS_PER_00328] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00145

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन FileStorage [SWS_PER_00460] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00129, RS_AP_00146

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन GetAllFileNames [SWS_PER_00110] Upstream: RS_PER_00001, RS_PER_00004, 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:

फ़ंक्शन GetCurrentFileSize [SWS_PER_00407] 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 (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन GetFileInfo [SWS_PER_00438] Upstream: RS_PER_00004, 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 (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन OpenFileReadOnly [SWS_PER_00114] Upstream: RS_PER_00001, RS_PER_00004, 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_00144, RS_AP_00159

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions: