클래스 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"
Scope	namespace ara::per
Basisklasse(n)	FileAccessor

사용자 가이드AI 생성

지속화된 파일 및 바이너리 데이터를 블록 단위, 줄 단위 또는 문자 기반으로 읽을 수 있도록 지원합니다.

AI 생성 미검증 모델: 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()는 정확히 1바이트를 읽고 위치를 전진시킵니다 [SWS_PER_00419]. 더 큰 데이터 블록은 ReadBinary(n)를 통해 ara::core::Vector<ara::core::Byte>로 읽어들일 수 있으며, 이때 위치는 그에 맞게 조정됩니다. 파일 끝에 조기 도달하면 벡터는 요청된 것보다 적은 수의 바이트를 포함하게 됩니다 [SWS_PER_00422]. ReadBinary()을 사용하면 파일 끝까지 남은 모든 바이트를 한 단계로 가져올 수 있습니다 [SWS_PER_00421].

시퀀스 다이어그램: 사전 검사 및 구간별 데이터 처리를 포함한 순차 읽기 접근의 일반적인 흐름. 출처: [SWS_PER_00418], [SWS_PER_00422], [SWS_PER_00421].

텍스트 모드에서 PeekChar()은 문자 기반 미리보기를 제공하며 [SWS_PER_00167], GetChar()는 다음 문자를 소비합니다 [SWS_PER_00168]. 줄 단위 읽기는 구분 기호(기본값: '\n', ASCII 0x0a)까지 읽는 ReadLine()를 통해 수행되며, 이때 구분 기호는 결과 문자열에 포함되지 않습니다 [SWS_PER_00119]. n개 문자 구간 또는 나머지 전체 내용은 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]. 문서화된 대표적인 오류 상태는 다음과 같습니다:

물리적 저장 매체 오류 발생 시 PerErrc::kPhysicalStorageFailure [SWS_PER_00419], [SWS_PER_00420],
읽기 포인터가 파일 끝에 있거나 파일이 비어 있는 경우 PerErrc::kEof [SWS_PER_00419], [SWS_PER_00168],
데이터의 유효성을 검증할 수 없는 경우 PerErrc::kValidationFailed [SWS_PER_00418], [SWS_PER_00119],
복호화 실패 시 PerErrc::kEncryptionFailed [SWS_PER_00419], [SWS_PER_00422], 그리고
저장된 데이터의 MAC 검증이 실패한 경우 PerErrc::kAuthenticationFailed [SWS_PER_00167], [SWS_PER_00421].

이 가이드는 AUTOSAR Adaptive R25-11 사양을 기반으로 하며 자동으로 생성되었습니다.

멤버 맵

생성자 및 소멸자

ReadAccessor ~ReadAccessor

메서드

GetByte GetChar PeekByte PeekChar ReadBinary ReadLine ReadText

클래스 다이어그램

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

상세 보기

개요에서 항목을 선택하세요.

이 릴리스에 대한 요소 데이터가 없습니다

생성자 및 소멸자

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

ara::core::Result< ara::core::Vector< ara::core::Byte > > ReadBinary () noexcept; SWS_PER_00421

ara::core::Result< ara::core::Vector< ara::core::Byte > > ReadBinary (std::uint64_t n) noexcept; SWS_PER_00422

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

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

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

항목을 클릭하면 관계가 표시됩니다.

메서드 문서

함수 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"
Scope	class ara::per::ReadAccessor
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00419
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00419@rel:R25-11#4f766963
Content hash: 4f766963
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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"
Scope	class ara::per::ReadAccessor
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00168
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00168@rel:R25-11#8ed57531
Content hash: 8ed57531
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: eb387be6a3cf 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::per::ReadAccessor 클래스의 동기식 멤버 함수 PeekByte은(는) 파일 위치를 변경하지 않고 파일의 현재 위치에서 단일 바이트를 읽습니다 [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(Message Authentication Code) 검증에 실패했습니다."

"실행 안전성 측면에서 해당 메서드는 noexcept 및 exception safe(으)로 선언되어 있습니다 [SWS_PER_00418]. 그러나 사양에서 PeekByte을(를) not thread-safe(으)로 분류하고 있으므로, ara::per::ReadAccessor의 동일한 인스턴스에 대한 병렬 호출은 애플리케이션 측의 동기화가 필요할 것으로 보입니다 [SWS_PER_00418]." 질문 Q-14b3334052f6c810 (열림)

이 사용 지침은 AUTOSAR 사양 R25-11을 바탕으로 AI에 의해 생성되었습니다.

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

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00418
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00418@rel:R25-11#847a7354
Content hash: 847a7354
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: b4d92aee30b2 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::per::ReadAccessor 클래스(헤더 #include "ara/per/read_accessor.h")의 PeekChar 메서드는 읽기 포인터를 변경하지 않고 파일의 현재 위치에 있는 문자를 읽습니다 [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"
Scope	class ara::per::ReadAccessor
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe PerErrc::kPhysical rollback_semantics

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00167
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00167@rel:R25-11#4c61c450
Content hash: 4c61c450
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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"
Scope	class 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#faf5b09b
Content hash: faf5b09b
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 325f0e841208 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::per::ReadAccessor 클래스의 매개변수 없는 메서드 ReadBinary은(는) 현재 파일 위치부터 파일 끝까지 남아 있는 모든 바이트를 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].

이 텍스트는 AI에 의해 생성되었습니다. 모든 정보는 AUTOSAR 명세의 요구사항을 기반으로 합니다.

구현자 가이드 준비 중 (복잡도 I1)

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

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00421
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00421@rel:R25-11#ca76f24c
Content hash: ca76f24c
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 4e14906b2550 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::per::ReadAccessor 클래스의 ReadBinary 함수는 현재 파일 위치부터 최대 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로 명시되어 있으므로 동일한 접근자에 대한 병렬 액세스는 애플리케이션 측에서 동기화되어야 합니다. 그러나 exception safe로 선언되어 있으며 noexcept(으)로 주석 처리되어 있습니다 [SWS_PER_00422]. 파일 끝까지 남아 있는 모든 바이트를 항상 읽는 매개변수 없는 오버로드 [SWS_PER_00421]와(과) 달리, 이 변형은 정의된 블록 크기를 부분적으로 읽어 들이는 것을 허용합니다.

이 텍스트는 AI에 의해 생성되었으며 큐레이션 보조 도구로 사용됩니다.

구현자 가이드 준비 중 (복잡도 I1)

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

Parameter (in)

Parameter	Beschreibung
n	Number of bytes to read.

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00422
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00422@rel:R25-11#68978edf
Content hash: 68978edf
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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;

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 30f46bde066b 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

ara::per::ReadAccessor 클래스의 동기식 메서드 ReadLine은(는) 지정된 구분 기호까지 전체 한 줄을 ara::core::String(으)로 읽어 들이고 읽기 위치를 그에 맞게 앞으로 이동합니다 [SWS_PER_00119]. 기본적으로 \n(ASCII 0x0a)가 구분 기호 역할을 하며, 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: 메시지 인증 코드(MAC) 검증이 실패했습니다 [SWS_PER_00119].

동시성 및 제약 조건

이 메서드는 noexcept(으)로 선언되어 있고 예외 안전(\"exception safe\")하지만, 명시적으로 스레드 안전하지 않습니다(\"not thread-safe\") [SWS_PER_00119]. 해석: 동일한 ReadAccessor 인스턴스에 대한 동시 호출의 경우 외부 동기화가 필요할 것으로 보입니다. 질문 Q-307b6e250938c76b (열림) 현재 읽기 위치가 여러 부분으로 구성된 유니코드 코드 포인트 중간에 있는 경우 반환된 문자열이 불완전한 코드 포인트로 시작될 수 있습니다 [SWS_PER_00119].

이 텍스트는 AI에 의해 작성되었으며 AUTOSAR 사양을 기반으로 합니다.

구현자 가이드 준비 중 (복잡도 I1)

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

Parameter (in)

Parameter	Beschreibung
delimiter	The character that is used as delimiter.

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00119
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00119@rel:R25-11#24fc3ea5
Content hash: 24fc3ea5
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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;

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 042205956a20 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::per::ReadAccessor 클래스의 동기 멤버 함수 ReadText은(는) 현재 파일 위치부터 최대 n개의 문자를 ara::core::String(으)로 읽어 들입니다 [SWS_PER_00165]. 포함(include)은 헤더 #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]. 현재 읽기 위치나 마지막으로 읽은 문자(코드 유닛)가 유니코드 코드 포인트의 중간에 위치하는 경우 반환된 문자열은 불완전한 코드 포인트로 시작하거나 끝날 수 있습니다 [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].

이 텍스트는 AI에 의해 작성되고 큐레이션되었습니다. 모든 정보는 AUTOSAR 릴리스 R25-11의 명세를 기반으로 합니다.

구현자 가이드 준비 중 (복잡도 I1)

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

Parameter (in)

Parameter	Beschreibung
n	Number of characters to read.

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
StorageFailure	Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00165
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00165@rel:R25-11#45bd1015
Content hash: 45bd1015
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 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.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: d5efea9a0341 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::per::ReadAccessor 클래스의 동기 메서드 ReadText은(는) 현재 파일 위치부터 남아 있는 모든 문자를 ara::core::String(으)로 읽어 들입니다 [SWS_PER_00420]. 이 함수는 매개변수를 받지 않으며 성공적으로 읽은 후 현재 위치를 파일 끝으로 설정합니다 [SWS_PER_00420]. 읽기 위치가 유니코드 코드 포인트의 중간에 위치하는 경우 반환된 문자열은 불완전한 코드 포인트로 시작할 수 있습니다 [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].

최대 n개의 문자를 읽고 그에 따라 위치를 전진시키는 관련 오버로드 ReadText(std::uint64_t n)과(와) 함께 사용될 때 [SWS_PER_00165], 매개변수가 없는 변형은 파일 끝까지의 전체 잔여 내용을 완전히 읽어 들이는 역할을 합니다 [SWS_PER_00420].

이 사용 지침은 AUTOSAR 사양 R25-11을 바탕으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

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

Rückgabewert

Typ	Beschreibung
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

Fehlercode	Beschreibung
PerErrc::kPhysicalStorageFailure	rollback_semantics Returned if access to the physical storage fails.
PerErrc::kValidationFailed	rollback_semantics Returned if the validity of stored data cannot be ensured.
PerErrc::kEncryptionFailed	rollback_semantics Returned if the decryption of stored data fails.
PerErrc::kEof	rollback_semantics Returned if the current position is at the end of the file or if the file is empty.
PerErrc::kAuthenticationFailed	rollback_semantics Returned if checking the MAC of stored data fails.

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

Record: AUTOSAR/AP/record/SWS_PER_00420
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00420@rel:R25-11#358bad8f
Content hash: 358bad8f
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 ~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"
Scope	class ara::per::ReadAccessor
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

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

Record: AUTOSAR/AP/record/SWS_PER_00417
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_PER_00417@rel:R25-11#3b435684
Content hash: 3b435684
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

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

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

클래스 ara::per::ReadAccessor

사용자 가이드AI 생성

컨텍스트 및 역할 범위

수명주기 및 동시성

바이너리 및 텍스트 데이터의 사용 경로

오류 시나리오 및 오류 처리

멤버 맵

생성자 및 소멸자

메서드

클래스 다이어그램

상세 보기

생성자 및 소멸자

메서드

메서드 문서

함수 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

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

사용

오류 처리

동시성 및 제약사항

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ReadAccessor [SWS_PER_00461] Upstream: RS_PER_00004, RS_AP_00120, RS_AP_00129, RS_AP_00146

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

사용

오류 처리

동시성 및 제약 조건

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 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

사용법 및 의미론

오류 처리 및 제약 조건

상호 작용