DEENESPTFRRUARHIKOZHNL

فئة ara::per::ReadAccessor

[SWS_PER_00342] Upstream: RS_PER_00004, RS_AP_00122, RS_AP_00146

class ReadAccessor :            public virtual FileAccessor {...};

ReadAccessor is used to read file data. It provides binary and text mode methods for checking or getting the current byte/character (PeekByte/PeekChar, GetByte/GetChar) methods for reading a section of a binary/text file (Read Binary/ReadText), a method to read a line of text (ReadLine).

Header-Datei#include "ara/per/read_accessor.h"
Forwarding-Header#include "ara/per/per_fwd.h"
Scopenamespace ara::per
Basisklasse(n)FileAccessor

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

يتيح قراءة بيانات الملفات والبيانات الثنائية المستدامة بنظام الكتل أو الأسطر أو الأحرف.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 811820211677 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتيح قراءة بيانات الملفات والبيانات الثنائية المستدامة بنظام الكتل أو الأسطر أو الأحرف.

توفر الفئة ara::per::ReadAccessor دوال متزامنة للقراءة التسلسلية والقائمة على الأسطر للملفات في الوضعين الثنائي والنصي [SWS_PER_00421]، [SWS_PER_00119]. وإلى جانب القراءة المستهلكة للبيانات، فإنها تتيح معاينة محايدة للمؤشر للبايتات أو الأحرف التالية. ونظرًا لأن النسخ غير آمنة ترابطيًا، يجب تنسيق عمليات الوصول المتزامنة خارجيًا، بينما يحمي ضمان التراجع موضع مؤشر القراءة في حالة حدوث خطأ [SWS_PER_00419].

السياق ونطاق المهام

توفر الفئة ara::per::ReadAccessor واجهة للقراءة المتزامنة لمحتويات الملفات ضمن إدارة الاستدامة (الوحدة per)، وتشتق افتراضيًا من FileAccessor. وهي تجرد الوصول بالقراءة إلى وحدات تخزين البيانات المستدامة وتوفر دوال وصول ثنائية ونصية على حد سواء. يمكن للتطبيقات فحص واسترجاع بايتات أو أحرف فردية، بالإضافة إلى قراءة كتل متصلة أو أسطر كاملة عبر دوال متخصصة.

دورة الحياة والتزامن

تم حذف المنشئ الافتراضي للفئة ReadAccessor [SWS_PER_00461]؛ ولذلك يتم إنشاء النسخة عادةً عبر آليات الفتح والوصول ذات المستوى الأعلى لوحدة الاستدامة. ويتم تحرير الواجهة وموارد الوصول المرتبطة بها عبر مدمّر الكائن الافتراضي ~ReadAccessor() [SWS_PER_00417]. تمتلك نسخ ReadAccessor مؤشر قراءة داخليًا يدير الموضع الحالي في الملف. تم تحديد جميع دوال الفئة صراحةً بأنها غير آمنة ترابطيًا (not thread-safe) [SWS_PER_00419]، ولهذا السبب يجب على جهات الاستدعاء مزامنة عمليات القراءة المتزامنة على النسخة نفسها خارجيًا.

مسارات الاستخدام للبيانات الثنائية والنصية

بالنسبة لعمليات الملفات الثنائية، تقدم الفئة دوال للقراءة القابلة للمعاينة أو التسلسلية. باستخدام PeekByte()، يمكن فحص البايت الموجود في موضع القراءة الحالي دون تغيير مؤشر القراءة [SWS_PER_00418]. وفي المقابل، يقرأ GetByte() بايتًا واحدًا بالضبط ويقدم الموضع إلى الأمام [SWS_PER_00419]. يمكن قراءة كتل بيانات أكبر عبر ReadBinary(n) في ara::core::Vector<ara::core::Byte>، مع ضبط الموضع وفقًا لذلك؛ وإذا تم الوصول إلى نهاية الملف قبل الأوان، فسيحتوي المتجه على بايتات أقل من المطلوب [SWS_PER_00422]. ومن خلال ReadBinary()، يمكن الحصول على جميع البايتات المتبقية حتى نهاية الملف في خطوة واحدة [SWS_PER_00421].

Sequenzielles Lesen von DateiinhaltenالتطبيقReadAccessorPeekByte()Result<Byte> (الموضع دون تغيير)ReadBinary(n)Result<Vector<Byte>> (الموضع يتقدم للأمام)ReadBinary()Result<Vector<Byte>> (Restinhalt bis Dateiende)

مخطط التسلسل: المسار النموذجي لعملية وصول بالقراءة التسلسلية مع فحص مسبق ومعالجة البيانات على أجزاء. المصادر: [SWS_PER_00418]، [SWS_PER_00422]، [SWS_PER_00421].

في الوضع النصي، يوفر PeekChar() معاينة قائمة على الأحرف [SWS_PER_00167]، بينما يستهلك GetChar() الحرف التالي [SWS_PER_00168]. وتتم القراءة سطراً بسطر عبر ReadLine()، الذي يقرأ حتى فاصل محدد (الافتراضي: '\n'، ASCII 0x0a)؛ ولا يتم تضمين الفاصل في السلسلة النصية للنتيجة [SWS_PER_00119]. يمكن قراءة مقاطع بطول n من الأحرف أو كامل المحتوى المتبقي عبر التحميلات الزائدة (Overloads) لـ ReadText() [SWS_PER_00165]، [SWS_PER_00420]. وإذا كان مؤشر القراءة في منتصف حرف متعدد البايتات، فقد تشتمل السلاسل النصية الناتجة على نقاط ترميز Unicode غير مكتملة [SWS_PER_00119]، [SWS_PER_00165].

سيناريوهات الأخطاء ومعالجتها

تُرجع جميع عمليات القراءة لـ ReadAccessor قيمها مغلفة في ara::core::Result، وتم تحديدها على أنها آمنة من الاستثناءات (exception safe) [SWS_PER_00419]. وإذا حدث خطأ أثناء الوصول، تُطبَّق دلالات تراجع صارمة: يظل الموضع الحالي لمؤشر القراءة ثابتًا دون تغيير في حالة حدوث خطأ [SWS_PER_00421]، [SWS_PER_00422]. تتضمن حالات الأخطاء الموثقة النموذجية ما يلي:

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive R25-11 وقد تم إنشاؤه آليًا.

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

المُنشئات والمُتلف

2

مخطط الفئة

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

G nara__per__ReadAccessor956 ReadAccessor + ReadAccessor() + ~ReadAccessor() + GetByte() + GetChar() + PeekByte() + PeekChar() + ReadBinary() + ReadLine() + ReadText() nara__per__FileAccessor932 FileAccessor nara__per__ReadAccessor956->nara__per__FileAccessor932 nara__per__ReadWriteAccessor483 ReadWriteAccessor nara__per__ReadWriteAccessor483->nara__per__ReadAccessor956

عرض التفاصيل

اختر عنصرًا من المخطط.

المُنشئات والمُتلف

ReadAccessor دالة

The default constructor for ReadAccessor shall not be used.

ReadAccessor ()=delete;
~ReadAccessor دالة

Destructor for ReadAccessor.

~ReadAccessor () override noexcept;

الدوال الأعضاء

GetByte دالة

Returns the byte at the current position of the file, advancing the current position. In case of an error, the current position is not changed.

ara::core::Result< ara::core::Byte > GetByte () noexcept;
GetChar دالة

Returns the character at the current position of the file, advancing the current position. In case of an error, the current position is not changed.

ara::core::Result< char > GetChar () noexcept;
PeekByte دالة

Returns the byte at the current position of the file. The current position is not changed.

ara::core::Result< ara::core::Byte > PeekByte () const noexcept;
PeekChar دالة

Returns the character at the current position of the file. The current position is not changed.

ara::core::Result< char > PeekChar () const noexcept;
ReadBinary دالة 2

Reads all remaining bytes into a Vector of Byte, starting from the current position. The current position is set to the end of the file. In case of an error, the current position is not changed.

التحميلات الزائدة ReadBinary 2
ReadLine دالة

Reads a complete line of characters into a String, advancing the current position accordingly. The end of the line is demarcated by the delimiter, or by "\\n" (ASCII 0x0a) if that parameter is omitted. The delimiter itself is not included in the returned String. Only Unicode code points with one character (code unit) can be used as delimiters. The returned string may start with an incomplete Unicode code point in case the current read position is in the middle of a code point. If the end of the file is reached, the remaining characters are returned and the current position is set to the end of the file. In case of an error, the current position is not changed.

ara::core::Result< ara::core::String > ReadLine (char delimiter=’\n’) noexcept;
ReadText دالة 2

Reads a number of characters into a String, starting from the current position. The returned string may start and/or end with incomplete Unicode code points in case the current read position and/or the last read character (code unit) is in the middle of a code point. The current position is advanced accordingly. If the end of the file is reached, the number of returned characters can be less than the requested number, and the current position is set to the end of the file. In case of an error, the current position is not changed.

التحميلات الزائدة ReadText 2

توثيق الدوال

دالة GetByte [SWS_PER_00419] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< ara::core::Byte > GetByte () noexcept;

Returns the byte at the current position of the file, advancing the current position. In case of an error, the current position is not changed.

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::Byte >A Result containing a byte. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00419
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00419@rel:R25-11#408d4db4
Content hash
408d4db4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00419
Status: valid/unmigrated Version: rel:R25-11#0912989a 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_00419@rel:R25-11#0912989a
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#0364504c2026-09-30
  • R20-11rel:R20-11#5413fe932026-10-14
  • R21-11rel:R21-11#942b773e2026-10-14
  • R22-11rel:R22-11#bd9006822026-10-14
  • R23-11rel:R23-11#a95950da2026-10-14
  • R24-11rel:R24-11#0912989a2026-10-14
  • R25-11rel:R25-11#0912989a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة GetChar [SWS_PER_00168] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< char > GetChar () noexcept;

Returns the character at the current position of the file, advancing the current position. In case of an error, the current position is not changed.

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

TypBeschreibung
ara::core::Result< char >A Result containing a character. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00168
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00168@rel:R25-11#e7120c48
Content hash
e7120c48
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00168
Status: valid/unmigrated Version: rel:R25-11#0c481b90 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_00168@rel:R25-11#0c481b90
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#3ca1a1292026-09-30
  • R19-11rel:R19-11#730eeb9f2026-10-14
  • R20-11rel:R20-11#8515a7212026-10-14
  • R21-11rel:R21-11#9651569a2026-10-14
  • R22-11rel:R22-11#cece1f3e2026-10-14
  • R23-11rel:R23-11#af3b07a02026-10-14
  • R24-11rel:R24-11#cbb2020f2026-10-14
  • R25-11rel:R25-11#0c481b902026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة PeekByte [SWS_PER_00418] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< ara::core::Byte > PeekByte () const noexcept;

Returns the byte at the current position of the file. The current position is not changed.

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

تقرأ الدالة العضو المتزامنة PeekByte للفئة ara::per::ReadAccessor بايتاً واحداً عند الموضع الحالي للملف دون تغيير موضع الملف [SWS_PER_00418]. تتطلب الدالة تضمين ملف الترويسة ara/per/read_accessor.h، ولا تأخذ أي معلمات، وتُرجع القيمة المقروءة في ara::core::Result<ara::core::Byte> [SWS_PER_00418].

في حال حدوث خطأ أثناء الوصول، يحتوي كائن الإرجاع إما على رمز خطأ خاص بالشركة المصنعة أو على أحد الأخطاء المحددة من PerErrc [SWS_PER_00418]:

  • PerErrc::kEof: الموضع الحالي موجود عند نهاية الملف أو أن الملف فارغ.
  • PerErrc::kPhysicalStorageFailure: فشل الوصول إلى التخزين الفعلي.
  • PerErrc::kValidationFailed: لا يمكن ضمان صلاحية البيانات المخزنة.
  • PerErrc::kEncryptionFailed: فشل فك تشفير البيانات المخزنة.
  • PerErrc::kAuthenticationFailed: فشل التحقق من MAC (رمز مصادقة الرسالة).

فيما يتعلق بأمان التنفيذ، تم التصريح عن الدالة كـ noexcept وexception safe [SWS_PER_00418]. ومع ذلك، نظراً لأن المواصفة تصنف PeekByte كـ not thread-safe، فمن المرجح أن تتطلب الاستدعاءات المتوازية على نفس المثيل من ara::per::ReadAccessor مزامنة من جانب التطبيق [SWS_PER_00418]. سؤال Q-14b3334052f6c810 (مفتوح)

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::Byte >A Result containing a byte. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00418
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00418@rel:R25-11#b06a6871
Content hash
b06a6871
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00418
Status: valid/unmigrated Version: rel:R25-11#728d6d2e 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_00418@rel:R25-11#728d6d2e
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#e281f9292026-09-30
  • R20-11rel:R20-11#4a5022882026-10-14
  • R21-11rel:R21-11#265813ae2026-10-14
  • R22-11rel:R22-11#7f25e6502026-10-14
  • R23-11rel:R23-11#413441c32026-10-14
  • R24-11rel:R24-11#3c1c4a1c2026-10-14
  • R25-11rel:R25-11#728d6d2e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة PeekChar [SWS_PER_00167] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00135, RS_AP_00139, RS_AP_00159

ara::core::Result< char > PeekChar () const noexcept;

Returns the character at the current position of the file. The current position is not changed.

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

تقرأ الدالة PeekChar للفئة ara::per::ReadAccessor (ملف الترويسة #include "ara/per/read_accessor.h") الحرف عند الموضع الحالي لملف دون تغيير مؤشر القراءة [SWS_PER_00167].

الاستخدام

تمتلك الدالة البصمة ara::core::Result<char> PeekChar() const noexcept;. وهي تعمل بشكل متزامن، وتم التصريح عنها كـ const وتضمن أمان الاستثناءات (exception safe) [SWS_PER_00167]. وتُستخدم كقيمة إرجاع ara::core::Result<char>، والتي تحتوي في حالة النجاح على الحرف المقروء [SWS_PER_00167].

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

إذا حدث خطأ، يُرجع ara::core::Result أخطاء خاصة بالشركة المصنعة أو أحد رموز الخطأ التالية من PerErrc [SWS_PER_00167]:

  • PerErrc::kEof: وصل موضع القراءة الحالي إلى نهاية الملف أو أن الملف فارغ [SWS_PER_00167].
  • PerErrc::kPhysicalStorageFailure: فشل الوصول إلى وسيط التخزين الفعلي [SWS_PER_00167].
  • PerErrc::kValidationFailed: لا يمكن ضمان صلاحية البيانات المخزنة [SWS_PER_00167].
  • PerErrc::kEncryptionFailed: فشل فك تشفير البيانات المخزنة [SWS_PER_00167].
  • PerErrc::kAuthenticationFailed: فشل التحقق من رمز مصادقة الرسالة (MAC) للبيانات [SWS_PER_00167].

التزامن والقيود

العملية ليست آمنة لخيوط المعالجة (not thread-safe) [SWS_PER_00167]. لذلك، يجب مزامنة عمليات الوصول المتوازية إلى نفس مثيل ReadAccessor بواسطة المتصل.

تستند ملاحظة الاستخدام هذه إلى مواصفات AUTOSAR Adaptive الإصدار R25-11.

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

TypBeschreibung
ara::core::Result< char >A Result containing a character. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00167
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00167@rel:R25-11#f0c704ab
Content hash
f0c704ab
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00167
Status: valid/unmigrated Version: rel:R25-11#0012349e 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_00167@rel:R25-11#0012349e
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4e561ee32026-09-30
  • R19-11rel:R19-11#a681f46f2026-10-14
  • R20-11rel:R20-11#484d8e7f2026-10-14
  • R21-11rel:R21-11#9ba26bcc2026-10-14
  • R22-11rel:R22-11#adc94cd82026-10-14
  • R23-11rel:R23-11#5efe621b2026-10-14
  • R24-11rel:R24-11#0012349e2026-10-14
  • R25-11rel:R25-11#0012349e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ReadAccessor [SWS_PER_00461] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00129, RS_AP_00146

ReadAccessor ()=delete;

The default constructor for ReadAccessor shall not be used.

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor

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

Record
AUTOSAR/AP/record/SWS_PER_00461
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00461@rel:R25-11#251e834d
Content hash
251e834d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00461
Status: valid/unmigrated Version: rel:R25-11#036da8e2 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_00461@rel:R25-11#036da8e2
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#030094252026-09-30
  • R21-11rel:R21-11#ebfad02e2026-10-14
  • R22-11rel:R22-11#2e0765fe2026-10-14
  • R23-11rel:R23-11#ab252e082026-10-14
  • R24-11rel:R24-11#036da8e22026-10-14
  • R25-11rel:R25-11#036da8e22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ReadBinary [SWS_PER_00421] 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< ara::core::Vector< ara::core::Byte > > ReadBinary () noexcept;

Reads all remaining bytes into a Vector of Byte, starting from the current position. The current position is set to the end of the file. In case of an error, the current position is not changed.

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

تقرأ الطريقة غير المزودة بمعلمات ReadBinary للفئة ara::per::ReadAccessor بشكل متزامن جميع البايتات المتبقية بدءًا من موضع الملف الحالي حتى نهاية الملف في ara::core::Vector<ara::core::Byte> [SWS_PER_00421]. بعد عملية قراءة ناجحة، يتم ضبط موضع الملف الحالي على نهاية الملف [SWS_PER_00421]. تكون قيمة الإرجاع مغلفة كـ ara::core::Result ومُعلنة كـ noexcept؛ تفسير: نظرًا لعدم وجود نوع إرجاع غير متزامن، فمن المرجح أن تحظر الطريقة المتصل. سؤال Q-8e6054123cea57ac (مفتوح)

في حال حدوث خطأ أثناء القراءة، يتم الاحتفاظ بموضع الملف الأصلي دون تغيير [SWS_PER_00421]. ويحتوي ara::core::Result المُرجع في هذه الحالة إما على أخطاء خاصة بالشركة المصنعة أو على أحد رموز الخطأ المحددة من PerErrc [SWS_PER_00421]:

  • PerErrc::kPhysicalStorageFailure: فشل الوصول إلى الذاكرة الفعلية [SWS_PER_00421].
  • PerErrc::kValidationFailed: لا يمكن ضمان صلاحية البيانات المخزنة [SWS_PER_00421].
  • PerErrc::kEncryptionFailed: فشل فك تشفير البيانات [SWS_PER_00421].
  • PerErrc::kAuthenticationFailed: فشل التحقق من MAC [SWS_PER_00421].
  • PerErrc::kEof: الملف فارغ أو أن موضع القراءة موجود بالفعل عند نهاية الملف [SWS_PER_00421].

تم تعريف الدالة على أنها آمنة من الاستثناءات (exception safe)، ولكن صراحةً غير آمنة لمؤشرات الترابط (not thread-safe) [SWS_PER_00421]. لذلك، يجب تنسيق الاستدعاءات المتزامنة على نفس ReadAccessor من جانب المتصل. ما لم يكن المطلوب قراءة كامل محتوى الملف المتبقي دفعة واحدة، بل مجرد مجموعة فرعية من البايتات، فيجب استخدام المتغير المحمل بشكل زائد ReadBinary(std::uint64_t n) بدلاً من ذلك [SWS_PER_00422].

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

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::Vector<ara::core::Byte > >A Result containing a Vector of Byte. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00421
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00421@rel:R25-11#dc0ddb47
Content hash
dc0ddb47
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00421
Status: valid/unmigrated Version: rel:R25-11#196469d1 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_00421@rel:R25-11#196469d1
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#eeeb41ef2026-09-30
  • R20-11rel:R20-11#8500f2512026-10-14
  • R21-11rel:R21-11#bdd2c0352026-10-14
  • R22-11rel:R22-11#573348522026-10-14
  • R23-11rel:R23-11#1941de772026-10-14
  • R24-11rel:R24-11#8e7d483b2026-10-14
  • R25-11rel:R25-11#196469d12026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ReadBinary [SWS_PER_00422] 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< ara::core::Vector< ara::core::Byte > > ReadBinary (std::uint64_t n) noexcept;

Reads a number of bytes into a Vector of Byte, starting from the current position. The current position is advanced accordingly. If the end of the file is reached, the number of returned bytes can be less than the requested number, and the current position is set to the end of the file. In case of an error, the current position is not changed.

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

تقرأ الدالة ReadBinary الخاصة بالفئة ara::per::ReadAccessor ما يصل إلى n بايت بشكل متزامن في ara::core::Vector<ara::core::Byte> بدءًا من موضع الملف الحالي [SWS_PER_00422]. عند نجاح عملية القراءة، يتم تقديم موضع الملف الحالي بمقدار عدد البايتات المقروءة؛ وإذا تم الوصول إلى نهاية الملف أثناء ذلك، فقد يحتوي المتجه المُرجع على أقل من n بايت، ويظل موضع الملف عند نهاية الملف [SWS_PER_00422].

في حال حدوث خطأ أثناء عملية القراءة، لا يتم تغيير موضع الملف [SWS_PER_00422]. تتم معالجة الأخطاء عبر ara::core::Result المُرجع، والذي قد يحتوي على رموز خطأ محددة من PerErrc أو أخطاء خاصة بالجهة المصنعة [SWS_PER_00422]:

  • PerErrc::kPhysicalStorageFailure: يفشل الوصول إلى وحدة التخزين الفعلية [SWS_PER_00422].
  • PerErrc::kValidationFailed: يتعذر ضمان التحقق من صحة البيانات المخزنة [SWS_PER_00422].
  • PerErrc::kEncryptionFailed: تفشل عملية فك تشفير البيانات المخزنة [SWS_PER_00422].
  • PerErrc::kEof: الموضع الحالي موجود بالفعل عند نهاية الملف أو أن الملف فارغ [SWS_PER_00422].
  • PerErrc::kAuthenticationFailed: يفشل فحص MAC (Message Authentication Code) الخاص بالبيانات [SWS_PER_00422].

فيما يتعلق بالتزامن، تم تحديد الطريقة بأنها not thread-safe، ولهذا السبب يجب مزامنة عمليات الوصول المتوازية إلى نفس الـ Accessor من جانب التطبيق؛ ومع ذلك، فقد تم التصريح عنها بأنها exception safe وتم تزويدها بالتعليق التوضيحي noexcept [SWS_PER_00422]. وعلى عكس التحميل الزائد الخالي من المعاملات [SWS_PER_00421]، والذي يقرأ دائمًا جميع البايتات المتبقية حتى نهاية الملف، يتيح هذا المتغير قراءة أحجام كتل محددة تدريجيًا.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو بمثابة مساعدة للتقييم.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Parameter (in)

ParameterBeschreibung
nNumber of bytes to read.

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::Vector<ara::core::Byte > >A Result containing a Vector of Byte. In case of an error, it contains any of the errors defined below, or a vendor specific error.

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00422
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00422@rel:R25-11#f27c26ae
Content hash
f27c26ae
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00422
Status: valid/unmigrated Version: rel:R25-11#6130fc46 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_00422@rel:R25-11#6130fc46
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#0c9042422026-09-30
  • R20-11rel:R20-11#fc873a932026-10-14
  • R21-11rel:R21-11#77fe785f2026-10-14
  • R22-11rel:R22-11#979493562026-10-14
  • R23-11rel:R23-11#1177696c2026-10-14
  • R24-11rel:R24-11#1d2549ee2026-10-14
  • R25-11rel:R25-11#6130fc462026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ReadLine [SWS_PER_00119] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00129, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00159

ara::core::Result< ara::core::String > ReadLine (char delimiter=’\n’) noexcept;

Reads a complete line of characters into a String, advancing the current position accordingly. The end of the line is demarcated by the delimiter, or by "\\n" (ASCII 0x0a) if that parameter is omitted. The delimiter itself is not included in the returned String. Only Unicode code points with one character (code unit) can be used as delimiters. The returned string may start with an incomplete Unicode code point in case the current read position is in the middle of a code point. If the end of the file is reached, the remaining characters are returned and the current position is set to the end of the file. In case of an error, the current position is not changed.

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

الاستخدام

تقرأ الطريقة المتزامنة ReadLine للفئة ara::per::ReadAccessor سطراً كاملاً حتى محدد معين إلى ara::core::String وتقدم موضع القراءة إلى الأمام وفقاً لذلك [SWS_PER_00119]. وبشكل افتراضي، يعمل \n (ASCII 0x0a) كمحدد؛ ويُسمح فقط بنقاط كود Unicode التي تتكون من وحدة كود واحدة كـ delimiter [SWS_PER_00119]. المحدد نفسه غير مضمن في السلسلة النصية الناتجة. إذا وصلت عملية القراءة إلى نهاية الملف، فسيتم إرجاع جميع الأحرف المتبقية حتى تلك النقطة ويتم تعيين الموضع على نهاية الملف [SWS_PER_00119].

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

تُرجع الدالة ara::core::Result<ara::core::String> [SWS_PER_00119]. في حالة حدوث خطأ، لا يتم تغيير الموضع الحالي [SWS_PER_00119]. وتشمل الأخطاء المحددة ما يلي:

  • PerErrc::kEof: موضع القراءة الحالي موجود في نهاية الملف أو أن الملف فارغ [SWS_PER_00119].
  • StorageFailure: فشل الوصول إلى وحدة التخزين الفعلية [SWS_PER_00119].
  • PerErrc::kValidationFailed: لا يمكن ضمان صلاحية البيانات المخزنة [SWS_PER_00119].
  • PerErrc::kEncryptionFailed: فشل فك تشفير البيانات [SWS_PER_00119].
  • PerErrc::kAuthenticationFailed: فشل التحقق من Message Authentication Code (MAC) [SWS_PER_00119].

التزامن والشروط الحدية

تم الإعلان عن الطريقة كـ noexcept وهي آمنة من الاستثناءات («exception safe»)، ولكنها صراحةً غير آمنة لخيوط المعالجة («not thread-safe») [SWS_PER_00119]. تفسير: في حالة الاستدعاءات المتزامنة على نفس مثيل ReadAccessor، يُرجح أن تكون هناك حاجة إلى مزامنة خارجية. سؤال Q-307b6e250938c76b (مفتوح) وإذا كان موضع القراءة الحالي موجوداً في منتصف نقطة كود Unicode متعددة الأجزاء، فقد تبدأ السلسلة النصية المُرجعة بنقطة كود غير مكتملة [SWS_PER_00119].

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

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Parameter (in)

ParameterBeschreibung
delimiterThe character that is used as delimiter.

Rückgabewert

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

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00119
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00119@rel:R25-11#dbe4572f
Content hash
dbe4572f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00119
Status: valid/unmigrated Version: rel:R25-11#65a53978 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_00119@rel:R25-11#65a53978
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#07ef27932026-09-30
  • R19-11rel:R19-11#d9c1707c2026-10-14
  • R20-11rel:R20-11#869afee72026-10-14
  • R21-11rel:R21-11#4e378ab62026-10-14
  • R22-11rel:R22-11#b00875a42026-10-14
  • R23-11rel:R23-11#50b708c12026-10-14
  • R24-11rel:R24-11#156cbc312026-10-14
  • R25-11rel:R25-11#65a539782026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ReadText [SWS_PER_00165] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00159

ara::core::Result< ara::core::String > ReadText (std::uint64_t n) noexcept;

Reads a number of characters into a String, starting from the current position. The returned string may start and/or end with incomplete Unicode code points in case the current read position and/or the last read character (code unit) is in the middle of a code point. The current position is advanced accordingly. If the end of the file is reached, the number of returned characters can be less than the requested number, and the current position is set to the end of the file. In case of an error, the current position is not changed.

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

تقرأ الدالة العضو المتزامنة ReadText الخاصة بالفئة ara::per::ReadAccessor ما يصل إلى n حرفًا بدءًا من الموضع الحالي للملف إلى ara::core::String [SWS_PER_00165]. يتم التضمين عبر ملف الرأس #include "ara/per/read_accessor.h" [SWS_PER_00165].

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

يتم استدعاء الطريقة باستخدام المعلمة std::uint64_t n وتُرجع ara::core::Result<ara::core::String> [SWS_PER_00165]. في حال نجاح عملية القراءة، يتم تقديم موضع القراءة الحالي وفقًا لعدد الأحرف المقروءة [SWS_PER_00165]. وإذا وصلت عملية القراءة إلى نهاية الملف، فقد يكون عدد الأحرف المُرجعة أقل من n المطلوب؛ ويتم في هذه الحالة ضبط موضع الملف على نهاية الملف [SWS_PER_00165]. وإذا كان موضع القراءة الحالي أو آخر حرف مقروء (وحدة الترميز) يقع في منتصف نقطة ترميز Unicode، فقد تبدأ السلسلة النصية المُرجعة أو تنتهي بنقاط ترميز غير مكتملة [SWS_PER_00165].

معالجة الأخطاء والشروط الحدية

في حالة حدوث خطأ، يظل موضع الملف دون تغيير [SWS_PER_00165]. قد يحتوي ara::core::Result المُرجع على أخطاء خاصة بالشركة المصنعة أو رموز الخطأ التالية [SWS_PER_00165]:

  • PerErrc::kPhysicalStorageFailure: فشل الوصول إلى وحدة التخزين الفعلية [SWS_PER_00165].
  • PerErrc::kValidationFailed: لا يمكن ضمان صلاحية البيانات المخزنة [SWS_PER_00165].
  • PerErrc::kEncryptionFailed: فشل فك تشفير البيانات المخزنة [SWS_PER_00165].
  • PerErrc::kEof: الموضع الحالي موجود بالفعل عند نهاية الملف أو أن الملف فارغ [SWS_PER_00165].
  • PerErrc::kAuthenticationFailed: فشل فحص MAC للبيانات [SWS_PER_00165].

فيما يتعلق بالتزامن، تم الإعلان عن الدالة على أنها آمنة من الاستثناءات (exception safe)، ولكنها صراحةً غير آمنة لمؤشرات الترابط (not thread-safe) [SWS_PER_00165]. وبالتالي يجب مزامنة الاستدعاءات المتوازية على نفس المثيل.

تفاعل

إلى جانب التحميل الزائد مع تحديد الطول، يوجد متغير بدون معلمات ReadText() [SWS_PER_00420]، يقرأ جميع الأحرف المتبقية بدءًا من الموضع الحالي حتى نهاية الملف.

تم إنشاء هذا النص ومراجعته بواسطة ذكاء اصطناعي. تستند جميع المعلومات إلى مواصفة إصدار AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe PerErrc::kPhysical rollback_semantics

Parameter (in)

ParameterBeschreibung
nNumber of characters to read.

Rückgabewert

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

Fehler

FehlercodeBeschreibung
StorageFailureReturned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00165
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00165@rel:R25-11#dcaf4ffb
Content hash
dcaf4ffb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00165
Status: valid/unmigrated Version: rel:R25-11#2aa15da4 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_00165@rel:R25-11#2aa15da4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#cc14eec62026-09-30
  • R19-11rel:R19-11#6ae823952026-10-14
  • R20-11rel:R20-11#45ea0c7d2026-10-14
  • R21-11rel:R21-11#659479ab2026-10-14
  • R22-11rel:R22-11#231d4b352026-10-14
  • R23-11rel:R23-11#7498db7f2026-10-14
  • R24-11rel:R24-11#9c84dfee2026-10-14
  • R25-11rel:R25-11#2aa15da42026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ReadText [SWS_PER_00420] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00135, RS_AP_00136, RS_AP_00139, RS_AP_00159

ara::core::Result< ara::core::String > ReadText () noexcept;

Reads all remaining characters into a String, starting from the current position. The returned string may start with an incomplete Unicode code point in case the current read position is in the middle of a code point. The current position is set to the end of the file. In case of an error, the current position is not changed.

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

تقرأ الطريقة المتزامنة ReadText للفئة ara::per::ReadAccessor جميع الأحرف المتبقية بدءًا من موضع الملف الحالي في ara::core::String [SWS_PER_00420]. لا تتوقع الدالة أي معلمات، وتضبط الموضع الحالي على نهاية الملف بعد نجاح القراءة [SWS_PER_00420]. إذا كان موضع القراءة في منتصف نقطة ترميز Unicode، فقد تبدأ السلسلة النصية المُرجعة بنقطة ترميز غير مكتملة [SWS_PER_00420].

قيمة الإرجاع هي ara::core::Result<ara::core::String> [SWS_PER_00420]. في حالة حدوث خطأ، يظل موضع الملف دون تغيير (دلالات التراجع) وتحتوي النتيجة إما على خطأ خاص بالشركة المصنعة أو رمز خطأ من PerErrc [SWS_PER_00420]:

  • PerErrc::kEof: الموضع الحالي موجود بالفعل عند نهاية الملف أو أن الملف فارغ [SWS_PER_00420].
  • PerErrc::kPhysicalStorageFailure: فشل الوصول إلى الذاكرة الفعلية [SWS_PER_00420].
  • PerErrc::kValidationFailed: لا يمكن ضمان صلاحية البيانات المخزنة [SWS_PER_00420].
  • PerErrc::kEncryptionFailed: فشل فك تشفير البيانات المخزنة [SWS_PER_00420].
  • PerErrc::kAuthenticationFailed: فشل فحص كود مصادقة الرسالة (MAC) [SWS_PER_00420].

فيما يتعلق بالتزامن، تم تحديد ReadText على أنها آمنة من الاستثناءات (exception safe) ومُعلنة بـ noexcept، ولكنها مصنفة صراحةً على أنها غير آمنة لمؤشرات الترابط [SWS_PER_00420].

بالتضافر مع التحميل الزائد ذي الصلة ReadText(std::uint64_t n)، والذي يقرأ n حرفًا كحد أقصى ويقدم الموضع وفقًا لذلك [SWS_PER_00165]، يُستخدم المتغير غير المزود بمعلمات للقراءة الكاملة لكافة المحتوى المتبقي حتى نهاية الملف [SWS_PER_00420].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفة AUTOSAR الإصدار R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

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

Fehler

FehlercodeBeschreibung
PerErrc::kPhysicalStorageFailurerollback_semantics Returned if access to the physical storage fails.
PerErrc::kValidationFailedrollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailedrollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEofrollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailedrollback_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_00420
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00420@rel:R25-11#2f9b99aa
Content hash
2f9b99aa
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00420
Status: valid/unmigrated Version: rel:R25-11#61b98c9e 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_00420@rel:R25-11#61b98c9e
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#eae1d52e2026-09-30
  • R20-11rel:R20-11#964160082026-10-14
  • R21-11rel:R21-11#87d5efdd2026-10-14
  • R22-11rel:R22-11#cb3fbb062026-10-14
  • R23-11rel:R23-11#0a34e0562026-10-14
  • R24-11rel:R24-11#6089d3262026-10-14
  • R25-11rel:R25-11#61b98c9e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ~ReadAccessor [SWS_PER_00417] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00129, RS_AP_00134, RS_AP_00145, RS_AP_00159

~ReadAccessor () override noexcept;

Destructor for ReadAccessor.

Header-Datei#include "ara/per/read_accessor.h"
Scopeclass ara::per::ReadAccessor
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_PER_00417
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PER_00417@rel:R25-11#6802aef3
Content hash
6802aef3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00417
Status: valid/unmigrated Version: rel:R25-11#bb549d8d 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_00417@rel:R25-11#bb549d8d
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#bf28177b2026-09-30
  • R20-11rel:R20-11#ef16863c2026-10-14
  • R21-11rel:R21-11#d902da112026-10-14
  • R22-11rel:R22-11#303367742026-10-14
  • R23-11rel:R23-11#1f8e44f12026-10-14
  • R24-11rel:R24-11#2707c6492026-10-14
  • R25-11rel:R25-11#bb549d8d2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill