DEENESPTFRRUARHIKOZHNL

클래스 ara::com::SamplePtr

[SWS_CM_00306] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

template <typename T> class SamplePtr {...};

Emulates a std::unique_ptr to an event sample.

The ara::com::SamplePtr behaves as a std::unique_ptr as long as the event/ field is subscribed to, or the Proxy it belongs to is not destroyed. The precondition defined in [SWS_CM_00085] and [SWS_CM_00087] must be fulfilled. Otherwise it is considered a violation.

Note: The SamplePtr is always passed with a const SampleType to the callable in GetNewSamples() (see [SWS_CM_00701]). Therefore the sample datatype (typename T) and the SamplePtr operators using the sample datatype (typename T) are implicitly declared as const. This means that the sample data will always be read-only.

Header-Datei#include "ara/com/service/sample_ptr.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com

사용자 가이드AI 생성

수신된 이벤트에 대한 독점적인 읽기 접근을 가능하게 하고 미들웨어 메모리의 수명을 제어합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: f5d97c2beaf2 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

수신된 이벤트에 대한 독점적인 읽기 접근을 가능하게 하고 미들웨어 메모리의 수명을 제어합니다.

이 템플릿 클래스는 std::unique_ptr을 모델로 하여 수신된 이벤트 샘플의 독점적 소유권을 캡슐화하며, 애플리케이션에 미들웨어 버퍼에 대한 직접적이고 불변인 읽기 접근 권한을 부여합니다(EXP ARAComAPI §5.3.5.4). 인스턴스는 새 샘플을 쿼리할 때 전달되고, 이동 시맨틱으로만 전송될 수 있으며, 메모리 공간을 점유 상태로 유지합니다([SWS_CM_11537]). 포인터의 소멸 또는 명시적인 null 처리가 이루어져야 버퍼 슬롯이 다시 해제됩니다. 유효성을 유지하려면 이벤트가 구독 상태를 유지하고 연관된 프록시가 존재해야 합니다.

컨텍스트

템플릿 클래스 ara::com::SamplePtr은 Adaptive Platform에서 수신된 이벤트 데이터(Event Samples)에 대한 중앙 접근 및 소유권 모델을 나타냅니다(EXP ARAComAPI §5.3.5.4). 의미론적으로 이 클래스는 std::unique_ptr를 모델로 한 독점적 스마트 포인터를 모방합니다(EXP ARAComAPI §5.3.5.4). 주요 상호작용 파트너는 애플리케이션 레벨, 수신 이벤트 또는 프록시 객체, 그리고 버퍼 리소스를 관리하는 기본 통신 미들웨어 ara::com입니다(EXP ARAComAPI, 44쪽, EXP ARAComAPI, 50쪽).

이 개념은 참조 기반의 제로 카피(Zero-Copy) 방식을 명시적으로 따릅니다. ara::com은 이벤트 데이터를 값 복사로 애플리케이션에 전달하는 대신 중앙 통신 버퍼에 대한 포인터 또는 참조를 전달합니다(EXP ARAComAPI, 50쪽). 일반적인 1:N 분배 시나리오에서 로컬 이벤트 캐시는 순수한 참조 업데이트를 통해 처리될 수 있으므로 메모리 오버헤드와 지연 시간을 최소화합니다(EXP ARAComAPI, 50쪽). 페이로드 데이터에 대한 접근은 개념적으로 엄격히 읽기 전용으로 설계되었습니다. 제공 시 SamplePtr은 항상 상수 페이로드 타입으로 인스턴스화되며(ara::com::SamplePtr<SampleType const>), 이에 따라 모든 접근 연산자는 암시적으로 상수입니다(EXP ARAComAPI, 39쪽, EXP ARAComAPI, 44쪽, [SWS_CM_00701]).

수명 주기

SamplePtr의 인스턴스는 기본 생성자를 통해 또는 nullptr을 사용하여 빈 포인터로 생성될 수 있습니다([SWS_CM_11534], [SWS_CM_11535]). 반면 페이로드 데이터로 채워진 유효한 인스턴스는 이벤트를 버퍼 슬롯으로 역직렬화할 때 미들웨어 내에서 생성되며, GetNewSamples()의 일부로서 애플리케이션 측 Callable로 전달됩니다(EXP ARAComAPI, 44쪽).

전달과 함께 애플리케이션으로의 완전한 소유권 이전(Ownership Transfer)이 발생합니다(EXP ARAComAPI §5.3.5.4). 소유권의 독점성을 보장하기 위해 복사 생성자와 복사 할당 연산자는 삭제되었습니다([SWS_CM_11536], [SWS_CM_11538]). 관리되는 메모리 슬롯의 전송은 이동 생성 또는 이동 할당을 통해서만 가능하며([SWS_CM_11537], [SWS_CM_11540]), Swap()는 두 포인터 내용의 교환을 허용합니다([SWS_CM_11544]).

SamplePtr 인스턴스가 존재하고 샘플을 유지하는 동안에는 미들웨어가 점유된 메모리 공간을 회수하거나 다시 쓸 수 없습니다(EXP ARAComAPI §5.3.5.4). 미들웨어 슬롯의 해제는 소멸자 호출을 통해 SamplePtr의 수명이 종료되거나([SWS_CM_11547]), 포인터가 Reset(nullptr) 또는 nullptr의 할당을 통해 명시적으로 비워질 때 비로소 이루어집니다([SWS_CM_11539], [SWS_CM_11545]).

diag_lebenszyklus Init Leer Leer (nullptr) Init->Leer SamplePtr() Verwaltend Verwaltend (Exklusiver Besitz) Init->Verwaltend GetNewSamples() Leer->Verwaltend Move-Zuweisung Zerstoert 파괴됨 Leer->Zerstoert ~SamplePtr() Verwaltend->Leer Reset(nullptr) Verwaltend->Verwaltend Swap() Verwaltend->Zerstoert ~SamplePtr()

상태 다이어그램: SamplePtr의 라이프사이클 단계 및 소유권 이전. 출처: [SWS_CM_11534], [SWS_CM_11537], [SWS_CM_11545], [SWS_CM_11547], EXP ARAComAPI §5.3.5.4.

사용 경로

데이터 접근의 전형적인 흐름은 다음 단계로 나뉩니다:

  1. 샘플 쿼리 트리거: 애플리케이션은 이벤트 프록시에서 GetNewSamples()을 호출하고 시그니처 void(ara::com::SamplePtr<SampleType const>)을 갖는 적절한 콜백 함수와 가져올 샘플 수의 상한을 전달합니다(EXP ARAComAPI, 44쪽).
  2. 콜백으로 전달: 새 데이터가 존재하고 버퍼 할당량이 소진되지 않은 경우, 미들웨어는 샘플을 역직렬화하고 새 SamplePtr 인스턴스를 콜백으로 전달합니다(EXP ARAComAPI, 44쪽).
  3. 종단 간(End-to-End) 상태 확인: 애플리케이션은 GetProfileCheckStatus()을(를) 통해 현재 데이터 패킷에 대한 E2E 보호 검사 결과를 조회할 수 있습니다([SWS_CM_90420]).
  4. 데이터 읽기: 애플리케이션 로직은 operator*([SWS_CM_11541]), operator->([SWS_CM_11542]) 또는 메서드 Get()([SWS_CM_11546])를 통해 관리되는 객체에 읽기 접근합니다.
  5. 추가 처리 또는 해제: 샘플을 콜백 이후에도 유지해야 하는 경우, 애플리케이션은 이동 생성을 통해 포인터를 자체 메모리 구조로 이동합니다([SWS_CM_11537]). 포인터가 콜백의 유효 범위에 남아 있는 경우 종료 시 자동으로 소멸되며([SWS_CM_11547]), 이는 미들웨어의 슬롯을 즉시 해제합니다(EXP ARAComAPI §5.3.5.4).
샘플 제공 및 메모리 관리 흐름애플리케이션Proxy / Eventara::com MiddlewareGetNewSamples(f, maxNumberOfSamples)보유 중인 샘플을 할당량에 대해 검사alt할당량 초과됨ErrorCode 반환버퍼에 새 샘플 포함됨Deserialisierung in Sample-Slotf(SamplePtr<SampleType const>)소유권 획득; * / -> / Get()을 통한 읽기 액세스 및 E2E 검사소멸(~SamplePtr) 또는 Reset(nullptr)메모리 슬롯 해제Result(Anzahl verarbeiteter Samples)

시퀀스 다이어그램: 소유권 이전 및 버퍼 해제를 포함한 GetNewSamples()의 상호작용 순서. 출처: [SWS_CM_11541], [SWS_CM_11547], [SWS_CM_90420], EXP ARAComAPI, 44쪽, EXP ARAComAPI §5.3.5.4.

오류 시나리오

SamplePtr을(를) 사용할 때는 특정 제약 조건 및 오류 원인에 유의해야 합니다:

  • 버퍼 할당량 소진: 미들웨어는 GetNewSamples()을(를) 호출할 때마다 애플리케이션이 현재 보유하고 있는 샘플 수가 이전에 Subscribe() 호출 시 보장된 할당량을 초과하는지 모니터링합니다. 할당량을 초과한 경우 GetNewSamples()은(는) 추가 샘플 제공을 거부하고 대신 ara::core::ErrorCode을(를) 반환합니다(EXP ARAComAPI, 44쪽, EXP ARAComAPI, 45쪽).
  • 구독 상실 또는 프록시 소멸로 인한 무효화: SamplePtr은(는) 기본 이벤트가 계속 구독 상태를 유지하고 상위 프록시 인스턴스가 존재하는 동안에만 std::unique_ptr처럼 결정론적으로 동작합니다. 구독 종료 또는 프록시 소멸 이후에도 포인터를 유지하는 것은 사전 조건 위반으로 간주됩니다.
  • 포인터 유효성 및 널 상태: operator bool()을(를) 통해 포인터의 할당 상태를 평가할 수 있습니다([SWS_CM_11543]). operator* 또는 operator->을(를) 통해 빈 포인터를 역참조하면 정의되지 않은 동작이 발생합니다. 모든 접근 및 수정 메서드는 noexcept(으)로 선언되어 있습니다([SWS_CM_11541], [SWS_CM_11542], [SWS_CM_11546]).
  • E2E 검증 오류: 유효하게 수신된 포인터가 전송 데이터에 오류가 없음을 반드시 보장하지는 않습니다. 애플리케이션은 GetProfileCheckStatus()의 반환값을 통해 종단 간 보호에서 데이터 손상이나 전송 지연이 보고되었는지 확인해야 합니다([SWS_CM_90420]).

이 클래스 가이드는 Adaptive Platform 릴리스 R25-11용 AUTOSAR 사양을 기반으로 AI 큐레이션 어시스턴트에 의해 생성되었습니다.

멤버 맵

생성자 및 소멸자

2
SamplePtr~SamplePtr

메서드

4
GetGetProfileCheckStatusResetSwap

연산자

4
operator booloperator*operator->operator=

클래스 다이어그램

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

G nara__com__SamplePtr589 SamplePtr + SamplePtr() + operator=() + ~SamplePtr() + Get() + GetProfileCheckStatus() + Reset() + Swap() + operator bool() + operator*() + operator->()

상세 보기

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

생성자 및 소멸자

SamplePtr 함수 4

Default constructor

오버로드 SamplePtr 4
constexpr SamplePtr () noexcept; SWS_CM_11534
constexpr SamplePtr (std::nullptr_t other) noexcept; SWS_CM_11535
SamplePtr (const SamplePtr &)=delete; SWS_CM_11536
SamplePtr (SamplePtr &&other) noexcept; SWS_CM_11537
~SamplePtr 함수

Destructor

~SamplePtr () noexcept;

메서드

Get 함수

Returns a pointer to the managed object.

T * Get () const noexcept;
GetProfileCheckStatus 함수

Returns the E2E protection check result

ara::com::e2e::ProfileCheckStatus GetProfileCheckStatus () const noexcept;
Reset 함수

Replaces the managed object.

void Reset (std::nullptr_t other) noexcept;
Swap 함수

Swaps the managed object.

void Swap (SamplePtr &other) noexcept;

연산자

operator bool 함수

Checks if the stored pointer is null

explicit operator bool () const noexcept;
operator* 함수

Dereferences the stored pointer.

T & operator* () const noexcept;
operator-> 함수

Dereferences the stored pointer.

T * operator-> () const noexcept;
operator= 함수 3

Copy assignment constructor deletion

오버로드 = 3
SamplePtr & operator= (const SamplePtr &)=delete; SWS_CM_11538
SamplePtr & operator= (std::nullptr_t other) noexcept; SWS_CM_11539
SamplePtr & operator= (SamplePtr &&other) noexcept; SWS_CM_11540

메서드 문서

함수 Get [SWS_CM_11546] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

T * Get () const noexcept;

Returns a pointer to the managed object.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 1cc8beae7ae3 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용법 및 의미론

함수 Get은(는) 헤더 ara/com/service/sample_ptr.h의 클래스 ara::com::SamplePtr의 매개변수가 없는 멤버 함수입니다 [SWS_CM_11546]. 인스턴스가 관리하는 객체에 대한 T* 유형의 원시 포인터를 동기적으로 반환합니다 [SWS_CM_11546]. ara::core::Future을(를) 제공하는 서비스 필드의 비동기 쿼리와 달리 [SWS_CM_00112], 이 접근은 호출 스레드에서 즉시 수행됩니다.

오류 처리 및 제약 조건

이 메서드는 noexcept(으)로 선언되어 있으며 예외 안전(exception safe)(으)로 명시되어 있습니다 [SWS_CM_11546]. C++ 예외를 통한 오류 상태는 발생하지 않습니다. 인스턴스가 현재 관리하는 객체가 없는 경우 반환되는 포인터는 아마도 nullptr일 것으로 보입니다. 참조된 데이터를 추가 처리하기 전에 E2E 모니터링 상태가 ara::com::e2e::SMState::kValid 상태인지, 프로파일 상태 검사에서 오류가 발생하지 않았는지 확인해야 합니다 [SWS_CM_90422]. 질문 Q-d850bd8ee144369a (열림)

상호작용 및 구분

통신 관리에서 Get은(는) 샘플 관리의 프레임워크 내에서 제공되는 수신된 값(샘플)에 대한 직접 데이터 액세스 역할을 합니다 AUTOSAR_AP_EXP_ARAComAPI §10 “GetNewSamples”. 이 함수는 다른 Get 작업과 명확히 구분되어야 합니다:

  • 필드 Getter: 프록시에서 서비스 필드를 검색하는 작업은 ara::core::Future을(를) 반환하는 Get()을(를) 통해 이루어지며 [SWS_CM_00112], 이를 위해 서버 측에 핸들러를 등록할 수 있습니다 [SWS_CM_00114].
  • E2E 상태: 필드 Getter의 모니터링 상태는 GetE2EStateMachineStateGetter을(를) 통해 별도로 확인됩니다 [SWS_CM_00145].

이 텍스트는 AI에 의해 작성되었으며 AUTOSAR 릴리스 R25-11을 기반으로 합니다.

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

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
T*A pointer to the managed object

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

Record
AUTOSAR/AP/record/SWS_CM_11546
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11546@rel:R25-11#02486cfd
Content hash
02486cfd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11546
Status: valid/unmigrated Version: rel:R25-11#ff040cc4 Versionshistorie & Revisions (1 transition, 3 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_CM_11546@rel:R25-11#ff040cc4
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#19683df22026-09-30
  • R24-11rel:R24-11#83411fd82026-10-14
  • R25-11rel:R25-11#ff040cc42026-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

함수 GetProfileCheckStatus [SWS_CM_90420] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

ara::com::e2e::ProfileCheckStatus GetProfileCheckStatus () const noexcept;

Returns the E2E protection check result

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::e2e::ProfileCheckStatusThe ara::com::e2e::ProfileCheckStatus

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

Record
AUTOSAR/AP/record/SWS_CM_90420
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_90420@rel:R25-11#a6ed3fd8
Content hash
a6ed3fd8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_90420
Status: valid/unmigrated Version: rel:R25-11#0b9ab03a 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_CM_90420@rel:R25-11#0b9ab03a
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#35d072212026-09-30
  • R19-11rel:R19-11#8060df8d2026-10-14
  • R20-11rel:R20-11#8060df8d2026-10-14
  • R21-11rel:R21-11#8060df8d2026-10-14
  • R22-11rel:R22-11#8060df8d2026-10-14
  • R23-11rel:R23-11#8060df8d2026-10-14
  • R24-11rel:R24-11#331b13032026-10-14
  • R25-11rel:R25-11#0b9ab03a2026-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

함수 Reset [SWS_CM_11545] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

void Reset (std::nullptr_t other) noexcept;

Replaces the managed object.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 0a03c7966b10 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

클래스 ara::com::SamplePtr의 멤버 함수 Reset은(는) 관리되는 객체에 대한 포인터를 재설정하는 데 사용됩니다 [SWS_CM_11545]. 매개변수로 std::nullptr_t 유형의 값 other을(를) 받습니다. 호출 시 현재 보유 중인 객체를 널 포인터로 대체하며 값을 반환하지 않습니다(void) [SWS_CM_11545].

오류 처리 및 예외 안전성과 관련하여, 이 메서드는 noexcept(으)로 선언되어 있으며 무조건적인 예외 안전(exception safe)(으)로 명시되어 있습니다 [SWS_CM_11545]. C++ 예외가 발생하지 않으며 특정 오류 코드가 보고되지도 않습니다.

전체 시스템에서 SamplePtr 인스턴스의 해제는 메모리 오류를 방지하기 위한 필수적인 전제 조건을 충족합니다:

해석: 포인터가 유효 범위를 자동으로 벗어나지 않는 경우, Reset(nullptr)의 명시적 호출은 이러한 수명 주기 전환 전에 이벤트 샘플에 대한 소유권을 결정론적으로 포기하기 위한 애플리케이션 시나리오에서의 직접적인 수단이 될 것으로 보입니다. 질문 Q-a615fa4078ab03ce (열림)

이 사용 참고사항은 AUTOSAR 사양 R25-11을 바탕으로 자동 작성되었습니다.

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

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherA replacing std::nullptr_t

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11545
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11545@rel:R25-11#2540976f
Content hash
2540976f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11545
Status: valid/unmigrated Version: rel:R25-11#93bd20e9 Versionshistorie & Revisions (1 transition, 3 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_CM_11545@rel:R25-11#93bd20e9
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#82ec68c82026-09-30
  • R24-11rel:R24-11#d3c7100f2026-10-14
  • R25-11rel:R25-11#93bd20e92026-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

함수 SamplePtr [SWS_CM_11534] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

constexpr SamplePtr () noexcept;

Default constructor

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_CM_11534
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11534@rel:R25-11#c605b36f
Content hash
c605b36f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11534
Status: valid/unmigrated Version: rel:R25-11#d0884e08 Versionshistorie & Revisions (1 transition, 3 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_CM_11534@rel:R25-11#d0884e08
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b186477a2026-09-30
  • R24-11rel:R24-11#78fdb2182026-10-14
  • R25-11rel:R25-11#d0884e082026-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

함수 SamplePtr [SWS_CM_11535] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

constexpr SamplePtr (std::nullptr_t other) noexcept;

Semantically equivalent to [SWS_CM_11534]

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherA std::nullptr_t to copy

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

Record
AUTOSAR/AP/record/SWS_CM_11535
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11535@rel:R25-11#53bc7134
Content hash
53bc7134
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11535
Status: valid/unmigrated Version: rel:R25-11#6e679051 Versionshistorie & Revisions (1 transition, 3 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_CM_11535@rel:R25-11#6e679051
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#fa854bdf2026-09-30
  • R24-11rel:R24-11#123387c32026-10-14
  • R25-11rel:R25-11#6e6790512026-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

함수 SamplePtr [SWS_CM_11536] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

SamplePtr (const SamplePtr &)=delete;

Copy constructor deletion

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr

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

Record
AUTOSAR/AP/record/SWS_CM_11536
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11536@rel:R25-11#483a70b2
Content hash
483a70b2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11536
Status: valid/unmigrated Version: rel:R25-11#1ab46188 Versionshistorie & Revisions (1 transition, 3 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_CM_11536@rel:R25-11#1ab46188
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#3909673e2026-09-30
  • R24-11rel:R24-11#1ab461882026-10-14
  • R25-11rel:R25-11#1ab461882026-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

함수 SamplePtr [SWS_CM_11537] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

SamplePtr (SamplePtr &&other) noexcept;

Move constructor

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::SamplePtr to move

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

Record
AUTOSAR/AP/record/SWS_CM_11537
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11537@rel:R25-11#9428b72d
Content hash
9428b72d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11537
Status: valid/unmigrated Version: rel:R25-11#3c5f39c0 Versionshistorie & Revisions (1 transition, 3 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_CM_11537@rel:R25-11#3c5f39c0
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#0fee22422026-09-30
  • R24-11rel:R24-11#165c3cab2026-10-14
  • R25-11rel:R25-11#3c5f39c02026-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

함수 Swap [SWS_CM_11544] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

void Swap (SamplePtr &other) noexcept;

Swaps the managed object.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 18d4b3f3f0f9 출처 열린 질문 (1)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

함수 Swap은(는) 클래스 ara::com::SamplePtr의 멤버 메서드이며 현재 관리되는 객체를 다른 인스턴스와 교환하는 데 사용됩니다([SWS_CM_11544]). 이 인터페이스는 헤더 ara/com/service/sample_ptr.h에 정의되어 있습니다(AUTOSAR_AP_SWS_CommunicationManagement §8.9.1.1.3.4 “Swap”).

호출은 동기적으로 이루어지며 다음과 같은 매개변수를 기대합니다:

  • other: 관리되는 객체가 *this의 객체와 교환될 ara::com::SamplePtr의 다른 인스턴스에 대한 참조입니다([SWS_CM_11544]).

이 메서드는 반환값이 없습니다(void)([SWS_CM_11544]).

오류 처리

시그니처는 noexcept(으)로 선언되어 있으며 예외 안전(exception safe)(으)로 분류됩니다([SWS_CM_11544]). 호출 시 예외가 발생하지 않으며 오류 코드가 반환되지 않습니다.

동시성 및 제약사항

Swap은(는) 두 객체(*this 및 other)의 상태를 동시에 변경하므로, 외부 동기화 없이 관련된 인스턴스 중 적어도 하나에 대해 병렬 호출을 수행하는 것은 스레드 안전하지 않을 것으로 보입니다. 질문 Q-d906e8c05aefbd15 (열림)

상호 작용

이 메서드는 클래스 ara::com::SamplePtr의 필수적인 구성 요소입니다([SWS_CM_11544]). 이를 통해 기반 페이로드 객체를 복사할 필요 없이 통신 흐름에서 수신된 데이터 샘플의 소유권을 효율적으로 이전하거나 재할당할 수 있습니다.

본 사용 지침은 사양 문서를 바탕으로 자동 생성되었습니다.

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

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherAnother ara::com::SamplePtr to swap the managed object with

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11544
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11544@rel:R25-11#1ee994ee
Content hash
1ee994ee
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11544
Status: valid/unmigrated Version: rel:R25-11#de8dd35c Versionshistorie & Revisions (1 transition, 3 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_CM_11544@rel:R25-11#de8dd35c
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#ef3edceb2026-09-30
  • R24-11rel:R24-11#f0b647d12026-10-14
  • R25-11rel:R25-11#de8dd35c2026-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

함수 operator bool [SWS_CM_11543] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

explicit operator bool () const noexcept;

Checks if the stored pointer is null

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
boolTRUE if the stored pointer is null, FALSE otherwise.

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

Record
AUTOSAR/AP/record/SWS_CM_11543
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11543@rel:R25-11#aba5769e
Content hash
aba5769e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11543
Status: valid/unmigrated Version: rel:R25-11#d4a800ef Versionshistorie & Revisions (1 transition, 3 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_CM_11543@rel:R25-11#d4a800ef
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#a426ffae2026-09-30
  • R24-11rel:R24-11#6ef9c5c82026-10-14
  • R25-11rel:R25-11#d4a800ef2026-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

함수 operator* [SWS_CM_11541] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

T & operator* () const noexcept;

Dereferences the stored pointer.

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
T&The object owned by *this

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

Record
AUTOSAR/AP/record/SWS_CM_11541
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11541@rel:R25-11#8bdc78c4
Content hash
8bdc78c4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11541
Status: valid/unmigrated Version: rel:R25-11#2a9978a3 Versionshistorie & Revisions (1 transition, 3 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_CM_11541@rel:R25-11#2a9978a3
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#7a10ec442026-09-30
  • R24-11rel:R24-11#ef9b07162026-10-14
  • R25-11rel:R25-11#2a9978a32026-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

함수 operator-> [SWS_CM_11542] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

T * operator-> () const noexcept;

Dereferences the stored pointer.

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
T*A pointer to the object owned by *this

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

Record
AUTOSAR/AP/record/SWS_CM_11542
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11542@rel:R25-11#fcc3e2cc
Content hash
fcc3e2cc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11542
Status: valid/unmigrated Version: rel:R25-11#40fe26b3 Versionshistorie & Revisions (1 transition, 3 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_CM_11542@rel:R25-11#40fe26b3
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#782b36dc2026-09-30
  • R24-11rel:R24-11#bcd1f0962026-10-14
  • R25-11rel:R25-11#40fe26b32026-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

함수 operator= [SWS_CM_11538] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

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

Copy assignment constructor deletion

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr

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

Record
AUTOSAR/AP/record/SWS_CM_11538
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11538@rel:R25-11#b9d4a355
Content hash
b9d4a355
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11538
Status: valid/unmigrated Version: rel:R25-11#26e1191d Versionshistorie & Revisions (1 transition, 3 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_CM_11538@rel:R25-11#26e1191d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#474e38fe2026-09-30
  • R24-11rel:R24-11#26e1191d2026-10-14
  • R25-11rel:R25-11#26e1191d2026-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

함수 operator= [SWS_CM_11539] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

SamplePtr & operator= (std::nullptr_t other) noexcept;

Copy assignment of nullptr_t.

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherA std::nullptr_t to copy

Rückgabewert

TypBeschreibung
SamplePtr &New ara::com::SamplePtr

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

Record
AUTOSAR/AP/record/SWS_CM_11539
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11539@rel:R25-11#b9a2e34f
Content hash
b9a2e34f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11539
Status: valid/unmigrated Version: rel:R25-11#f4df352d Versionshistorie & Revisions (1 transition, 3 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_CM_11539@rel:R25-11#f4df352d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#3c9545952026-09-30
  • R24-11rel:R24-11#2a2a48bc2026-10-14
  • R25-11rel:R25-11#f4df352d2026-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

함수 operator= [SWS_CM_11540] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

SamplePtr & operator= (SamplePtr &&other) noexcept;

Move assignment operator.

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::SamplePtr to move

Rückgabewert

TypBeschreibung
SamplePtr &New ara::com::SamplePtr

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

Record
AUTOSAR/AP/record/SWS_CM_11540
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11540@rel:R25-11#c225ab1d
Content hash
c225ab1d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11540
Status: valid/unmigrated Version: rel:R25-11#19726bd5 Versionshistorie & Revisions (1 transition, 3 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_CM_11540@rel:R25-11#19726bd5
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#d5c9766f2026-09-30
  • R24-11rel:R24-11#0e9fed532026-10-14
  • R25-11rel:R25-11#19726bd52026-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

함수 ~SamplePtr [SWS_CM_11547] Upstream: RS_CM_00202, RS_CM_00203, RS_AP_00114, RS_AP_00122, RS_AP_00135, RS_AP_00145

~SamplePtr () noexcept;

Destructor

Header-Datei#include "ara/com/service/sample_ptr.h"
Scopeclass ara::com::SamplePtr
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_CM_11547
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11547@rel:R25-11#f899deb4
Content hash
f899deb4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11547
Status: valid/unmigrated Version: rel:R25-11#9a0210b5 Versionshistorie & Revisions (1 transition, 3 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_CM_11547@rel:R25-11#9a0210b5
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#79b025ea2026-09-30
  • R24-11rel:R24-11#12a7c5cb2026-10-14
  • R25-11rel:R25-11#9a0210b52026-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