DEENESPTFRRUARHIKOZHNL

class 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

User GuideKI-GENERIERT

Ermöglicht das blockweise, zeilenweise oder zeichenbasierte Lesen persistierter Datei- und Binärdaten.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 811820211677 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Ermöglicht das blockweise, zeilenweise oder zeichenbasierte Lesen persistierter Datei- und Binärdaten.

Die Klasse ara::per::ReadAccessor stellt synchrone Methoden zum sequenziellen und zeilenbasierten Lesen von Dateien im Binär- und Textmodus bereit [SWS_PER_00421], [SWS_PER_00119]. Neben dem konsumierenden Lesen erlaubt sie die zeigerneutrale Vorschau auf folgende Bytes oder Zeichen. Da Instanzen nicht threadsicher sind, müssen parallele Zugriffe extern koordiniert werden, während im Fehlerfall eine Rollback-Garantie die Lesezeigerposition schützt [SWS_PER_00419].

Kontext und Aufgabenbereich

Die Klasse ara::per::ReadAccessor stellt eine Schnittstelle zum synchronen Lesen von Dateiinhalten innerhalb der Persistenzverwaltung (Modul per) bereit und leitet virtuell von FileAccessor ab. Sie abstrahiert den Lesezugriff auf persistierte Datenspeicher und stellt sowohl binäre als auch textuelle Zugriffsmethoden bereit. Anwendungen können über spezialisierte Funktionen einzelne Bytes oder Zeichen prüfen und abrufen sowie zusammenhängende Blöcke oder vollständige Zeilen einlesen.

Lebenszyklus und Nebenläufigkeit

Der Standardkonstruktor von ReadAccessor ist gelöscht [SWS_PER_00461]; die Instanziierung erfolgt daher typischerweise vermittelt über übergeordnete Öffnungs- und Zugriffsmechanismen des Persistenzmoduls. Die Freigabe der Schnittstelle und der gebundenen Zugriffsressourcen erfolgt über den virtuellen Destruktor ~ReadAccessor() [SWS_PER_00417]. Instanzen von ReadAccessor besitzen einen internen Lesezeiger, der die aktuelle Position in der Datei verwaltet. Sämtliche Methoden der Klasse sind explizit als nicht threadsicher (not thread-safe) spezifiziert [SWS_PER_00419], weshalb gleichzeitige Leseoperationen auf derselben Instanz von Aufrufern extern synchronisiert werden müssen.

Nutzungspfade für Binär- und Textdaten

Für binäre Dateioperationen bietet die Klasse Funktionen zum vorschaubaren oder sequenziellen Auslesen. Mit PeekByte() kann das Byte an der aktuellen Leseposition inspiziert werden, ohne den Lesezeiger zu verändern [SWS_PER_00418]. Dagegen liest GetByte() genau ein Byte aus und rückt die Position vor [SWS_PER_00419]. Größere Datenblöcke lassen sich über ReadBinary(n) in einen ara::core::Vector<ara::core::Byte> einlesen, wobei die Position entsprechend angepasst wird; wird das Dateiende vorzeitig erreicht, enthält der Vektor weniger Bytes als angefordert [SWS_PER_00422]. Mittels ReadBinary() können alle verbleibenden Bytes bis zum Dateiende in einem Schritt bezogen werden [SWS_PER_00421].

Sequenzielles Lesen von DateiinhaltenAnwendungReadAccessorPeekByte()Result<Byte> (Position unverändert)ReadBinary(n)Result<Vector<Byte>> (Position rückt vor)ReadBinary()Result<Vector<Byte>> (Restinhalt bis Dateiende)

Sequenzdiagramm: Typischer Ablauf eines sequenziellen Lesezugriffs mit Vorabprüfung und abschnittsweiser Datenverarbeitung. Quellen: [SWS_PER_00418], [SWS_PER_00422], [SWS_PER_00421].

Im Textmodus stellt PeekChar() eine zeichenbasierte Vorschau bereit [SWS_PER_00167], während GetChar() das nächste Zeichen konsumiert [SWS_PER_00168]. Das zeilenweise Lesen erfolgt über ReadLine(), das bis zu einem Trennzeichen liest (Standard: '\n', ASCII 0x0a); das Trennzeichen wird dabei nicht in den Ergebnisstring übernommen [SWS_PER_00119]. Abschnitte von n Zeichen oder der gesamte Restinhalt lassen sich über die Überladungen von ReadText() auslesen [SWS_PER_00165], [SWS_PER_00420]. Befindet sich der Lesezeiger inmitten eines Mehrbyte-Zeichens, können die resultierenden Zeichenketten unvollständige Unicode-Codepunkte aufweisen [SWS_PER_00119], [SWS_PER_00165].

Fehlerszenarien und Fehlerbehandlung

Alle Leseoperationen von ReadAccessor liefern ihre Werte gekapselt in einem ara::core::Result zurück und sind als ausnahmesicher (exception safe) spezifiziert [SWS_PER_00419]. Tritt während eines Zugriffs ein Fehler auf, greift eine strikte Rollback-Semantik: Die aktuelle Position des Lesezeigers bleibt im Fehlerfall stets unverändert [SWS_PER_00421], [SWS_PER_00422]. Typische dokumentierte Fehlerzustände umfassen:

Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive R25-11 und wurde automatisiert erstellt.

Mitgliederkarte

Klassendiagramm

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

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

ReadAccessor function

The default constructor for ReadAccessor shall not be used.

ReadAccessor ()=delete;
~ReadAccessor function

Destructor for ReadAccessor.

~ReadAccessor () override noexcept;

Methoden

GetByte function

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 function

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 function

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 function

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

ara::core::Result< char > PeekChar () const noexcept;
ReadBinary function 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.

Überladungen ReadBinary 2
ReadLine function

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 function 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.

Überladungen ReadText 2

Dokumentation der Methoden

function 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#0364504c
Content hash
0364504c
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

function 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#3ca1a129
Content hash
3ca1a129
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: eb387be6a3cf Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die synchrone Memberfunktion PeekByte der Klasse ara::per::ReadAccessor liest ein einzelnes Byte an der aktuellen Position der Datei aus, ohne die Dateiposition zu verändern [SWS_PER_00418]. Die Funktion erfordert die Einbindung des Headers ara/per/read_accessor.h, nimmt keine Parameter entgegen und gibt den gelesenen Wert in einem ara::core::Result<ara::core::Byte> zurück [SWS_PER_00418].

Tritt während des Zugriffs ein Fehler auf, enthält das Rückgabeobjekt entweder einen herstellerspezifischen Fehlercode oder einen der definierten Fehler aus PerErrc [SWS_PER_00418]:

  • PerErrc::kEof: Die aktuelle Position befindet sich am Ende der Datei oder die Datei ist leer.
  • PerErrc::kPhysicalStorageFailure: Der Zugriff auf den physischen Speicher ist fehlgeschlagen.
  • PerErrc::kValidationFailed: Die Validität der gespeicherten Daten kann nicht gewährleistet werden.
  • PerErrc::kEncryptionFailed: Die Entschlüsselung der gespeicherten Daten schlug fehl.
  • PerErrc::kAuthenticationFailed: Die Überprüfung des MAC (Message Authentication Code) schlug fehl.

Hinsichtlich der Ausführungssicherheit ist die Methode als noexcept und exception safe deklariert [SWS_PER_00418]. Da die Spezifikation PeekByte jedoch als not thread-safe einstuft, dürften parallele Aufrufe auf derselben Instanz von ara::per::ReadAccessor einer anwendungsseitigen Synchronisation bedürfen [SWS_PER_00418]. Frage Q-14b3334052f6c810 (offen)

Dieser Nutzungshinweis wurde von einer KI auf Basis der AUTOSAR-Spezifikation R25-11 generiert.

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#e281f929
Content hash
e281f929
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: b4d92aee30b2 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Methode PeekChar der Klasse ara::per::ReadAccessor (Header #include "ara/per/read_accessor.h") liest das Zeichen an der aktuellen Position einer Datei aus, ohne den Lesezeiger zu verändern [SWS_PER_00167].

Verwendung

Die Funktion besitzt die Signatur ara::core::Result<char> PeekChar() const noexcept;. Sie arbeitet synchron, ist als const deklariert und garantiert Ausnahme-Sicherheit (exception safe) [SWS_PER_00167]. Als Rückgabewert dient ein ara::core::Result<char>, welches im Erfolgsfall das ausgelesene Zeichen enthält [SWS_PER_00167].

Fehlerbehandlung

Tritt ein Fehler auf, liefert das ara::core::Result herstellerspezifische Fehler oder einen der folgenden Fehlercodes aus PerErrc [SWS_PER_00167]:

  • PerErrc::kEof: Die aktuelle Leseposition hat das Dateiende erreicht oder die Datei ist leer [SWS_PER_00167].
  • PerErrc::kPhysicalStorageFailure: Der Zugriff auf das physische Speichermedium ist fehlgeschlagen [SWS_PER_00167].
  • PerErrc::kValidationFailed: Die Gültigkeit der gespeicherten Daten kann nicht sichergestellt werden [SWS_PER_00167].
  • PerErrc::kEncryptionFailed: Die Entschlüsselung der gespeicherten Daten ist fehlgeschlagen [SWS_PER_00167].
  • PerErrc::kAuthenticationFailed: Die Überprüfung des Message Authentication Code (MAC) der Daten schlug fehl [SWS_PER_00167].

Nebenläufigkeit und Einschränkungen

Die Operation ist nicht threadsicher (not thread-safe) [SWS_PER_00167]. Daher müssen parallele Zugriffe auf dieselbe ReadAccessor-Instanz durch den Aufrufer synchronisiert werden.

Dieser Nutzungshinweis basiert auf der Spezifikation AUTOSAR Adaptive Release 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#4e561ee3
Content hash
4e561ee3
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

function 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#03009425
Content hash
03009425
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 325f0e841208 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die parameterlose Methode ReadBinary der Klasse ara::per::ReadAccessor liest synchron alle ab der aktuellen Dateiposition verbleibenden Bytes bis zum Dateiende in einen ara::core::Vector<ara::core::Byte> ein [SWS_PER_00421]. Nach erfolgreichem Lesevorgang wird die aktuelle Dateiposition auf das Dateiende gesetzt [SWS_PER_00421]. Der Rückgabewert ist als ara::core::Result gekapselt und als noexcept deklariert; Interpretation: Da kein asynchroner Rückgabetyp vorliegt, dürfte die Methode den Aufrufer blockieren. Frage Q-8e6054123cea57ac (offen)

Tritt beim Lesen ein Fehler auf, bleibt die ursprüngliche Dateiposition unverändert erhalten [SWS_PER_00421]. Das zurückgegebene ara::core::Result enthält in diesem Fall entweder herstellerspezifische Fehler oder einen der spezifischen Fehlercodes aus PerErrc [SWS_PER_00421]:

  • PerErrc::kPhysicalStorageFailure: Der physische Speicherzugriff schlägt fehl [SWS_PER_00421].
  • PerErrc::kValidationFailed: Die Validität der gespeicherten Daten kann nicht sichergestellt werden [SWS_PER_00421].
  • PerErrc::kEncryptionFailed: Die Entschlüsselung der Daten schlägt fehl [SWS_PER_00421].
  • PerErrc::kAuthenticationFailed: Die Verifikation des MAC schlägt fehl [SWS_PER_00421].
  • PerErrc::kEof: Die Datei ist leer oder die Leseposition steht bereits am Dateiende [SWS_PER_00421].

Die Funktion ist als ausnahmesicher (exception safe), jedoch ausdrücklich als nicht threadsicher (not thread-safe) definiert [SWS_PER_00421]. Nebenläufige Aufrufe auf demselben ReadAccessor müssen daher vom Aufrufer koordiniert werden. Sofern nicht der gesamte verbleibende Dateiinhalt auf einmal, sondern nur eine Teilmenge an Bytes gelesen werden soll, ist stattdessen die überladene Variante ReadBinary(std::uint64_t n) zu verwenden [SWS_PER_00422].

Dieser Text wurde von einer KI erstellt. Alle Angaben basieren auf den Anforderungen der AUTOSAR-Spezifikation.

Implementer's Guide folgt (Komplexität 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#eeeb41ef
Content hash
eeeb41ef
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 4e14906b2550 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Funktion ReadBinary der Klasse ara::per::ReadAccessor liest ausgehend von der aktuellen Dateiposition bis zu n Bytes synchron in einen ara::core::Vector<ara::core::Byte> ein [SWS_PER_00422]. Bei erfolgreichem Lesevorgang wird die aktuelle Dateiposition um die Anzahl der gelesenen Bytes weitergesetzt; wird dabei das Dateiende erreicht, kann der zurückgegebene Vektor weniger als n Bytes enthalten, und die Dateiposition verbleibt am Dateiende [SWS_PER_00422].

Tritt während des Lesevorgangs ein Fehler auf, wird die Dateiposition nicht verändert [SWS_PER_00422]. Die Fehlerbehandlung erfolgt über das zurückgegebene ara::core::Result, welches spezifische Fehlercodes aus PerErrc oder herstellerspezifische Fehler enthalten kann [SWS_PER_00422]:

  • PerErrc::kPhysicalStorageFailure: Zugriff auf den physischen Speicher schlägt fehl [SWS_PER_00422].
  • PerErrc::kValidationFailed: Validierung der gespeicherten Daten kann nicht sichergestellt werden [SWS_PER_00422].
  • PerErrc::kEncryptionFailed: Entschlüsselung der gespeicherten Daten schlägt fehl [SWS_PER_00422].
  • PerErrc::kEof: Die aktuelle Position befindet sich bereits am Dateiende oder die Datei ist leer [SWS_PER_00422].
  • PerErrc::kAuthenticationFailed: Prüfung des MAC (Message Authentication Code) der Daten schlägt fehl [SWS_PER_00422].

Hinsichtlich der Nebenläufigkeit ist die Methode als not thread-safe spezifiziert, weshalb parallele Zugriffe auf denselben Accessor anwendungsseitig synchronisiert werden müssen; sie ist jedoch als exception safe deklariert und mit noexcept annotiert [SWS_PER_00422]. Im Unterschied zur parameterlosen Überladung [SWS_PER_00421], welche stets alle verbleibenden Bytes bis zum Dateiende liest, erlaubt diese Variante das stückweise Einlesen definierter Blockgrößen.

Dieser Text wurde von einer KI generiert und dient als Kurationshilfe.

Implementer's Guide folgt (Komplexität 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#0c904242
Content hash
0c904242
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 30f46bde066b Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die synchrone Methode ReadLine der Klasse ara::per::ReadAccessor liest eine vollständige Zeile bis zu einem festgelegten Trennzeichen in einen ara::core::String ein und setzt die Leseposition entsprechend vorwärts [SWS_PER_00119]. Standardmäßig fungiert \n (ASCII 0x0a) als Begrenzer; als delimiter sind ausschließlich Unicode-Codepunkte zulässig, die aus einer einzelnen Code-Einheit bestehen [SWS_PER_00119]. Das Trennzeichen selbst ist nicht im Ergebnisstring enthalten. Erreicht der Lesevorgang das Dateiende, werden alle bis dahin verbleibenden Zeichen zurückgegeben und die Position wird auf das Dateiende gesetzt [SWS_PER_00119].

Fehlerbehandlung

Die Funktion gibt ein ara::core::Result<ara::core::String> zurück [SWS_PER_00119]. Tritt ein Fehler auf, wird die aktuelle Position nicht verändert [SWS_PER_00119]. Zu den spezifizierten Fehlern gehören:

  • PerErrc::kEof: Die aktuelle Leseposition steht am Dateiende oder die Datei ist leer [SWS_PER_00119].
  • StorageFailure: Der Zugriff auf den physischen Speicher schlägt fehl [SWS_PER_00119].
  • PerErrc::kValidationFailed: Die Validität der gespeicherten Daten kann nicht sichergestellt werden [SWS_PER_00119].
  • PerErrc::kEncryptionFailed: Die Entschlüsselung der Daten schlägt fehl [SWS_PER_00119].
  • PerErrc::kAuthenticationFailed: Die Überprüfung des Message Authentication Code (MAC) schlägt fehl [SWS_PER_00119].

Nebenläufigkeit und Randbedingungen

Die Methode ist als noexcept deklariert und ausnahmesicher („exception safe“), aber explizit nicht threadsicher („not thread-safe“) [SWS_PER_00119]. Interpretation: Bei nebenläufigen Aufrufen auf derselben ReadAccessor-Instanz dürfte eine externe Synchronisation erforderlich sein. Frage Q-307b6e250938c76b (offen) Befindet sich die aktuelle Leseposition inmitten eines mehrteiligen Unicode-Codepunkts, kann die zurückgegebene Zeichenkette mit einem unvollständigen Codepunkt beginnen [SWS_PER_00119].

Dieser Text wurde von einer KI erstellt und basiert auf der AUTOSAR-Spezifikation.

Implementer's Guide folgt (Komplexität 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#07ef2793
Content hash
07ef2793
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 042205956a20 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die synchrone Elementfunktion ReadText der Klasse ara::per::ReadAccessor liest ab der aktuellen Dateiposition bis zu n Zeichen in einen ara::core::String ein [SWS_PER_00165]. Das Einbinden erfolgt über den Header #include "ara/per/read_accessor.h" [SWS_PER_00165].

Verwendung und Semantik

Die Methode wird mit dem Parameter std::uint64_t n aufgerufen und liefert ein ara::core::Result<ara::core::String> zurück [SWS_PER_00165]. Bei erfolgreichem Lesevorgang wird die aktuelle Leseposition entsprechend der gelesenen Zeichenanzahl weitergerückt [SWS_PER_00165]. Erreicht der Lesevorgang das Dateiende, kann die Anzahl der zurückgegebenen Zeichen kleiner als das angeforderte n sein; die Dateiposition wird dabei auf das Dateiende gesetzt [SWS_PER_00165]. Falls die aktuelle Leseposition oder das letzte gelesene Zeichen (Code-Unit) inmitten eines Unicode-Codepunkts liegt, kann der zurückgegebene String mit unvollständigen Codepunkten beginnen oder enden [SWS_PER_00165].

Fehlerbehandlung und Randbedingungen

Im Fehlerfall bleibt die Dateiposition unverändert [SWS_PER_00165]. Das zurückgegebene ara::core::Result kann herstellerspezifische Fehler oder folgende Fehlercodes enthalten [SWS_PER_00165]:

  • PerErrc::kPhysicalStorageFailure: Physischer Speicherzugriff ist fehlgeschlagen [SWS_PER_00165].
  • PerErrc::kValidationFailed: Die Validität der gespeicherten Daten kann nicht gewährleistet werden [SWS_PER_00165].
  • PerErrc::kEncryptionFailed: Die Entschlüsselung der gespeicherten Daten ist fehlgeschlagen [SWS_PER_00165].
  • PerErrc::kEof: Die aktuelle Position befindet sich bereits am Dateiende oder die Datei ist leer [SWS_PER_00165].
  • PerErrc::kAuthenticationFailed: Die MAC-Prüfung der Daten ist fehlgeschlagen [SWS_PER_00165].

Hinsichtlich Nebenläufigkeit ist die Funktion als ausnahmesicher (exception safe), aber ausdrücklich als nicht threadsicher (not thread-safe) deklariert [SWS_PER_00165]. Parallele Aufrufe auf derselben Instanz müssen folglich synchronisiert werden.

Zusammenspiel

Neben der Überladung mit Längenbegrenzung existiert eine parameterlose Variante ReadText() [SWS_PER_00420], welche ab der aktuellen Position alle verbleibenden Zeichen bis zum Dateiende liest.

Dieser Text wurde von einer KI erstellt und kuratiert. Alle Angaben stützen sich auf die Spezifikation des AUTOSAR-Releases R25-11.

Implementer's Guide folgt (Komplexität 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#cc14eec6
Content hash
cc14eec6
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: d5efea9a0341 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die synchrone Methode ReadText der Klasse ara::per::ReadAccessor liest alle ab der aktuellen Dateiposition verbleibenden Zeichen in ein ara::core::String ein [SWS_PER_00420]. Die Funktion erwartet keine Parameter und setzt nach erfolgreichem Lesen die aktuelle Position an das Dateiende [SWS_PER_00420]. Befindet sich die Leseposition inmitten eines Unicode-Codepunkts, kann der zurückgegebene String mit einem unvollständigen Codepunkt beginnen [SWS_PER_00420].

Der Rückgabewert ist ein ara::core::Result<ara::core::String> [SWS_PER_00420]. Tritt ein Fehler auf, bleibt die Dateiposition unverändert (Rollback-Semantik) und das Ergebnis enthält entweder einen herstellerspezifischen Fehler oder einen Fehlercode aus PerErrc [SWS_PER_00420]:

  • PerErrc::kEof: Die aktuelle Position steht bereits am Dateiende oder die Datei ist leer [SWS_PER_00420].
  • PerErrc::kPhysicalStorageFailure: Der Zugriff auf den physikalischen Speicher schlägt fehl [SWS_PER_00420].
  • PerErrc::kValidationFailed: Die Gültigkeit der gespeicherten Daten kann nicht gewährleistet werden [SWS_PER_00420].
  • PerErrc::kEncryptionFailed: Die Entschlüsselung der gespeicherten Daten schlägt fehl [SWS_PER_00420].
  • PerErrc::kAuthenticationFailed: Die Prüfung des Message Authentication Code (MAC) schlägt fehl [SWS_PER_00420].

Hinsichtlich Nebenläufigkeit ist ReadText als ausnahmesicher (exception safe) spezifiziert und mit noexcept deklariert, jedoch explizit als nicht threadsicher eingestuft [SWS_PER_00420].

Im Zusammenspiel mit der verwandten Überladung ReadText(std::uint64_t n), welche maximal n Zeichen liest und die Position entsprechend voranschreiten lässt [SWS_PER_00165], dient die parameterlose Variante dem vollständigen Einlesen des gesamten Restinhalts bis zum Dateiende [SWS_PER_00420].

Dieser Verwendungshinweis wurde automatisiert anhand der AUTOSAR-Spezifikation R25-11 erstellt.

Implementer's Guide folgt (Komplexität 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#eae1d52e
Content hash
eae1d52e
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

function ~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#bf28177b
Content hash
bf28177b
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