DEENESPTFRRUARHIKOZHNL

클래스 ara::shwa::Id

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_SHWA_00701] 문구 아직 가져오지 않음 Upstream: RS_SHWA_00017

template <int Dimensions = 1> class Id final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/id.h"
Scopenamespace ara::shwa

사용자 가이드AI 생성

하드웨어 및 메모리 리소스를 주소 지정하기 위한 다차원 인덱스 식별자 역할을 합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 5df852eb2dec 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

하드웨어 및 메모리 리소스를 주소 지정하기 위한 다차원 인덱스 식별자 역할을 합니다.

템플릿 클래스 ara::shwa::Id은 shwa 모듈에서 다차원 식별자를 캡슐화하며 Create [AP_SWS_SHWA_00707]과 같은 정적 팩토리 메서드를 통한 제어된 인스턴스화를 강제합니다. 복사 및 이동 가능한 값 객체로서 Get 및 Set [AP_SWS_SHWA_00710]을 통해 개별 차원 인덱스에 대한 접근을 허용합니다. 읽기 및 쓰기 접근과 다차원 팩토리는 스레드 안전하지 않으므로 필요한 동기화는 호출 애플리케이션의 책임입니다.

컨텍스트

템플릿 클래스 ara::shwa::Id은 shwa 모듈 내에서 공유 메모리 또는 하드웨어 가속기 구조를 위한 다차원 식별 또는 인덱싱을 나타냅니다. 이 클래스는 정적 팩토리 메서드를 통해 인스턴스화된 후 조회하거나 수정할 수 있는 좌표 또는 차원 인덱스를 캡슐화합니다. 이 클래스는 final으로 선언되어 있으며 기본값이 1인 템플릿 매개변수 Dimensions을 통해 차원 수를 매개변수화합니다. 상호작용 파트너로는 일반적으로 가속기 버퍼 또는 메모리 리소스에 대한 구조화된 접근을 주소 지정해야 하는 애플리케이션 컴포넌트가 나타납니다. 이때 ara::shwa::Id의 인스턴스 객체는 차원 관련 주소 지정을 위한 컴팩트한 값 객체 역할을 합니다.

수명 주기

ara::shwa::Id의 인스턴스화에는 엄격한 규정이 적용됩니다. 기본 생성자는 명시적으로 삭제되었습니다 [AP_SWS_SHWA_00702]. 따라서 직접적인 초기화되지 않은 객체 생성은 불가능합니다. 대신 ara::core::Result에 캡슐화된 객체를 반환하는 정적 팩토리 함수 Create를 통해 제어된 생성이 수행됩니다 [AP_SWS_SHWA_00707], [AP_SWS_SHWA_00708], [AP_SWS_SHWA_00709]. 요구되는 차원 수에 따라 1차원 [AP_SWS_SHWA_00707], 2차원 [AP_SWS_SHWA_00708] 또는 3차원 [AP_SWS_SHWA_00709]을 위한 오버로드가 제공됩니다.

소유권과 관련하여 ara::shwa::Id은 일반적인 값 객체처럼 동작합니다. 복사 생성자 [AP_SWS_SHWA_00703]과 복사 대입 연산자 [AP_SWS_SHWA_00704]을 모두 표준화(default) 및 예외 안전(noexcept)으로 구현합니다. 마찬가지로 이동 생성자 [AP_SWS_SHWA_00705]와 이동 대입 연산자 [AP_SWS_SHWA_00706]도 noexcept과 함께 제공됩니다. 따라서 인스턴스를 컨테이너에 효율적으로 저장하거나, 값으로 전달하거나, 프로그램 부분 간에 이동할 수 있습니다. 스레드 안전성에 각별한 주의가 필요합니다. 1차원 팩토리 메서드는 스레드 안전한 것으로 명시되어 있지만 [AP_SWS_SHWA_00707], 2차원 및 3차원 팩토리 메서드는 명시적으로 스레드 안전하지 않은 것으로 지정되어 있습니다 [AP_SWS_SHWA_00708], [AP_SWS_SHWA_00709]. 다차원 인덱스를 병렬로 초기화할 때 호출자는 적절한 동기화 조치를 마련해야 합니다.

사용 경로

전형적인 사용 흐름에는 적절한 팩토리 호출을 통한 제어된 인스턴스화, Result 객체 확인, 그리고 각 차원에 대한 후속 읽기 및 쓰기 연산이 포함됩니다. 먼저 애플리케이션은 원하는 차원 경계 또는 인덱스 값을 사용하여 Create을 호출합니다. ara::core::Result<Id>이 성공적으로 반환되면 그 안에 포함된 값이 언패킹됩니다. 상수 메서드 Get를 통해 특정 차원의 인덱스 값을 조회할 수 있습니다 [AP_SWS_SHWA_00710]. 필요한 경우 Set을 통해 특정 차원의 값을 사후에 변경할 수 있습니다 [AP_SWS_SHWA_00711]. 두 메서드(Get 및 Set)는 모두 스레드 안전하지 않은 것으로 분류됩니다. 여러 스레드에서 동일한 인스턴스에 동시 접근할 경우 외부에서 동기화해야 합니다.

Nutzungspfad von ara::shwa::Id애플리케이션ara::shwa::IdCreate(dim0)ara::core::Result<Id>altResult에 값이 포함됨Get(dimension)size_t indexSet(dimension, new_index)FehlerfallShwaErrorCode::kRuntime에 대한 오류 처리

시퀀스 다이어그램: Id 객체의 팩토리 생성, 값 조회 및 사후 수정의 일반적인 흐름. 출처: [AP_SWS_SHWA_00707], [AP_SWS_SHWA_00710], [AP_SWS_SHWA_00711]

오류 시나리오

정적 Create 메서드를 통한 생성 시 런타임 오류가 발생할 수 있습니다. 인스턴스화에 실패하면 팩토리 메서드는 오류 코드 ShwaErrorCode::kRuntime가 포함된 ara::core::Result을 반환합니다 [AP_SWS_SHWA_00707], [AP_SWS_SHWA_00708], [AP_SWS_SHWA_00709]. 따라서 호출자는 인스턴스에 접근하기 전에 반드시 HasValue()을 통해 반환값을 확인해야 합니다. 모든 Create 함수는 롤백 시맨틱을 보장하며 예외 안전(noexcept)으로 선언되어 있습니다.

실행 중 메서드 Get 및 Set을 사용할 때는 사양에 따라 이들이 예외 안전하지 않고(not exception safe) 스레드 안전하게 동작하지 않는다는 점에 유의해야 합니다 [AP_SWS_SHWA_00710], [AP_SWS_SHWA_00711]. 해석: 이들 메서드에 잘못된 매개변수가 전달될 경우 별도의 오류 코드가 정의되어 있지 않으므로, 유효한 값 범위를 벗어나는 부적절한 차원 값을 전달하면 정의되지 않은 동작이나 예외가 발생할 것으로 추정됩니다. 질문 Q-6983f5f27702e6e8 (열림) 호출자는 호출 전에 인수 dimension가 인스턴스의 유효한 한계 내에 있는지 확인해야 합니다.

이 가이드는 R25-11용 AUTOSAR 사양을 기반으로 AI 어시스턴트에 의해 생성되었습니다.

멤버 맵

생성자 및 소멸자

1

메서드

3

연산자

1

상세 보기

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

생성자 및 소멸자

Id 함수 3

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

오버로드 Id 3
Id ()=delete; AP_SWS_SHWA_00702
Id (Id &&other) noexcept=default; AP_SWS_SHWA_00705
Id (Id const &other) noexcept=default; AP_SWS_SHWA_00703

메서드

Create 함수 3

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

오버로드 Create 3
static ara::core::Result< Id > Create (const std::size_t dim0) noexcept; AP_SWS_SHWA_00707
static ara::core::Result< Id > Create (std::size_t dim0, std::size_t dim1, std::size_t dim2) noexcept; AP_SWS_SHWA_00709
static ara::core::Result< Id > Create (std::size_t dim0, std::size_t dim1) noexcept; AP_SWS_SHWA_00708
Get 함수

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

size_t Get (int dimension) const;
Set 함수

Schreibt den übergebenen Wert an die durch die Signatur bestimmte Stelle.

void Set (int dimension, size_t index);

연산자

operator= 함수 2

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

오버로드 = 2
Id & operator= (Id &&other) noexcept=default; AP_SWS_SHWA_00706
Id & operator= (const Id &other) noexcept=default; AP_SWS_SHWA_00704

세부 정보

함수 Id [AP_SWS_SHWA_00702] Upstream: RS_SHWA_00017

Id ()=delete;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::Id

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00702
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00702@rel:R25-11#acaed5cc
Content hash
acaed5cc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00702
Status: valid/unmigrated Version: rel:R25-11#833c0ba4 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00702@rel:R25-11#833c0ba4
Point-in-Time History:
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

함수 Id [AP_SWS_SHWA_00705] Upstream: RS_SHWA_00017

Id (Id &&other) noexcept=default;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::Id
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00705
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00705@rel:R25-11#7771f2dd
Content hash
7771f2dd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00705
Status: valid/unmigrated Version: rel:R25-11#4f69351d Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00705@rel:R25-11#4f69351d
Point-in-Time History:
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

함수 operator= [AP_SWS_SHWA_00706] Upstream: RS_SHWA_00017

Id & operator= (Id &&other) noexcept=default;

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

Scopeclass ara::shwa::Id
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00706
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00706@rel:R25-11#35b6df20
Content hash
35b6df20
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00706
Status: valid/unmigrated Version: rel:R25-11#5eeeb8a4 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00706@rel:R25-11#5eeeb8a4
Point-in-Time History:
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

함수 operator= [AP_SWS_SHWA_00704] Upstream: RS_SHWA_00017

Id & operator= (const Id &other) noexcept=default;

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

Scopeclass ara::shwa::Id
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00704
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00704@rel:R25-11#8a24acc4
Content hash
8a24acc4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00704
Status: valid/unmigrated Version: rel:R25-11#4bbd86ed Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00704@rel:R25-11#4bbd86ed
Point-in-Time History:
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

함수 Id [AP_SWS_SHWA_00703] Upstream: RS_SHWA_00017

Id (Id const &other) noexcept=default;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::Id
Exception Safetyexception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00703
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00703@rel:R25-11#4c136479
Content hash
4c136479
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00703
Status: valid/unmigrated Version: rel:R25-11#de227365 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00703@rel:R25-11#de227365
Point-in-Time History:
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

함수 Create [AP_SWS_SHWA_00707] Upstream: RS_SHWA_00017, RS_SHWA_00007

static ara::core::Result< Id > Create (const std::size_t dim0) noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::Id
Thread Safetythread-safe rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k Runtime General runtime error

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00707
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00707@rel:R25-11#3cbc7a5a
Content hash
3cbc7a5a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00707
Status: valid/unmigrated Version: rel:R25-11#3e45cfe1 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00707@rel:R25-11#3e45cfe1
Point-in-Time History:
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

함수 Create [AP_SWS_SHWA_00709] Upstream: RS_SHWA_00017, RS_SHWA_00007

static ara::core::Result< Id > Create (std::size_t dim0, std::size_t dim1, std::size_t dim2) noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::Id
Thread Safetynot thread-safe rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k Runtime General runtime error

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00709
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00709@rel:R25-11#f1e6d5d7
Content hash
f1e6d5d7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00709
Status: valid/unmigrated Version: rel:R25-11#b4c724b1 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00709@rel:R25-11#b4c724b1
Point-in-Time History:
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

함수 Create [AP_SWS_SHWA_00708] Upstream: RS_SHWA_00017, RS_SHWA_00007

static ara::core::Result< Id > Create (std::size_t dim0, std::size_t dim1) noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::Id
Thread Safetynot thread-safe rollback_semantics
Exception Safetyexception safe
ErrorsShwaErrorCode::k Runtime General runtime error

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00708
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00708@rel:R25-11#aa258f4e
Content hash
aa258f4e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00708
Status: valid/unmigrated Version: rel:R25-11#4a451411 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00708@rel:R25-11#4a451411
Point-in-Time History:
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

함수 Get [AP_SWS_SHWA_00710] Upstream: RS_SHWA_00017

size_t Get (int dimension) const;

Liest die durch die Signatur bezeichnete Information oder Eigenschaft aus dem Objekt.

Scopeclass ara::shwa::Id
Thread Safetynot thread-safe
Exception Safetynot exception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00710
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00710@rel:R25-11#d1552731
Content hash
d1552731
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00710
Status: valid/unmigrated Version: rel:R25-11#030f3bd4 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00710@rel:R25-11#030f3bd4
Point-in-Time History:
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

함수 Set [AP_SWS_SHWA_00711] Upstream: RS_SHWA_00017

void Set (int dimension, size_t index);

Schreibt den übergebenen Wert an die durch die Signatur bestimmte Stelle.

Scopeclass ara::shwa::Id
Thread Safetynot thread-safe
Exception Safetynot exception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00711
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00711@rel:R25-11#8f676ab6
Content hash
8f676ab6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00711
Status: valid/unmigrated Version: rel:R25-11#8da74c75 Versionshistorie & Revisions (1 transition)
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/AP_SWS_SHWA_00711@rel:R25-11#8da74c75
Point-in-Time History:
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