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

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

يمكّن من وصول القراءة الحصري إلى الأحداث المستلمة ويتحكم في فترة بقاء ذاكرة البرمجيات الوسيطة.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: 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). ويتم تمرير المثيلات عند الاستعلام عن عينات جديدة، ولا يمكن نقلها إلا عبر دلالات النقل (Move semantics) وتُبقي مساحة الذاكرة محجوزة ([SWS_CM_11537]). ولا يتم تحرير فتحة المخزن المؤقت مجددًا إلا عند تدمير المؤشر أو التصفير الصريح. وتتطلب الصلاحية أن يظل الحدث مشترَكًا به وأن يكون الوكيل المقترن به موجودًا.

السياق

تمثل فئة القالب 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]). في المقابل، تنشأ المثيلات الصالحة والمشغولة ببيانات الحمولة النافعة داخل البرمجية الوسيطة (Middleware) عند إلغاء تسلسل الأحداث في فتحات المخزن المؤقت وتُمرر كجزء من GetNewSamples() إلى كائن قابل للاستدعاء من جانب التطبيق (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 موجود ويحتفظ بـ Sample، فلا يمكن للبرمجية الوسيطة استعادة مساحة الذاكرة المشغولة أو الكتابة فوقها من جديد (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. بدء استعلام Sample: يستدعي التطبيق GetNewSamples() على وكيل الحدث ويمرر دالة رد نداء مناسبة بالبنية المميزة void(ara::com::SamplePtr<SampleType const>) بالإضافة إلى حد أقصى لعدد Samples المراد جلبها (EXP ARAComAPI, ص. 44).
  2. التمرير إلى دالة رد النداء: في حال توفر بيانات جديدة وعدم استنفاد حصة المخزن المؤقت، تقوم البرمجية الوسيطة بإلغاء تسلسل Sample وتمرير مثيل 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. مواصلة المعالجة أو التحرير: إذا كان من المقرر إبقاء Sample بعد انتهاء دالة رد النداء، ينقل التطبيق المؤشر عبر الإنشاء بالنقل إلى هياكل الذاكرة الخاصة به ([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() ما إذا كان عدد Samples التي يحتفظ بها التطبيق حاليًا يتجاوز الحصة المضمونة مسبقًا عند استدعاء Subscribe(). وإذا تم تجاوز الحصة، يرفض GetNewSamples() إخراج المزيد من Samples ويعيد بدلاً من ذلك 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()، يجب على التطبيق التحقق مما إذا كانت حماية End-to-End تشير إلى تلف البيانات أو تأخيرات في الإرسال ([SWS_CM_90420]).

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

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

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

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.

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

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

الدالة Get هي دالة عضو بدون معلمات للفئة ara::com::SamplePtr من ملف الترويسة ara/com/service/sample_ptr.h [SWS_CM_11546]. وتُرجع بشكل متزامن مؤشرًا أوليًا من النوع T* إلى الكائن المُدار بواسطة النسخة [SWS_CM_11546]. وبخلاف الاستعلامات غير المتزامنة لحقول الخدمة التي توفر ara::core::Future [SWS_CM_00112]، يتم هذا الوصول مباشرة في مؤشر الترابط (Thread) المستدعي.

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

تم التصريح عن الطريقة كـ noexcept وحُددت بأنها آمنة من الاستثناءات (exception safe) [SWS_CM_11546]؛ ولا تحدث حالات خطأ عبر استثناءات C++‎. إذا كانت النسخة لا تدير حاليًا أي كائن، فمن المفترض على الأرجح أن يكون المؤشر المُرجع nullptr. سؤال Q-d850bd8ee144369a (مفتوح) وقبل متابعة معالجة البيانات المشار إليها، يجب التأكد من أن مراقبة E2E في الحالة ara::com::e2e::SMState::kValid وأن فحص حالة ملف التعريف (Profile) لم يُسفر عن أي خطأ [SWS_CM_90422].

التفاعل والتمايز

في إدارة الاتصالات، تُستخدم Get للوصول المباشر إلى البيانات للقيم المستلمة (العينات)، كما يتم توفيرها كجزء من إدارة العينات AUTOSAR_AP_EXP_ARAComAPI §10 «GetNewSamples». ويجب تمييز هذه الدالة بوضوح عن عمليات Get الأخرى:

  • دالة جلب الحقل (Field-Getter): يتم استرداد حقول الخدمة في الوكيل عبر Get() مع إرجاع ara::core::Future [SWS_CM_00112]، والتي يمكن تسجيل معالج لها من جانب الخادم [SWS_CM_00114].
  • حالة E2E: يتم تحديد حالة المراقبة لدالة جلب الحقل بشكل منفصل عبر GetE2EStateMachineStateGetter [SWS_CM_00145].

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند إلى إصدار 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#4edaf721
Content hash
4edaf721
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#c77b4919
Content hash
c77b4919
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.

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

تُستخدم الدالة العضو Reset للفئة ara::com::SamplePtr لإعادة تعيين المؤشر إلى الكائن المُدار [SWS_CM_11545]. وتأخذ كمعلمة القيمة other من النوع std::nullptr_t. يستبدل الاستدعاء الكائن المحتفظ به حاليًا بمؤشر خالي ولا يُرجع أي قيمة (void) [SWS_CM_11545].

فيما يتعلق بمعالجة الأخطاء وأمان الاستثناءات، تم التصريح عن الطريقة بـ noexcept وحُددت بأنها آمنة تمامًا من الاستثناءات (exception safe) [SWS_CM_11545]. ولا يتم إطلاق أي استثناءات C++‎ ولا الإبلاغ عن رموز أخطاء محددة.

في النظام الكلي، يفي تحرير نسخ SamplePtr بشرط مسبق أساسي لتجنب أخطاء الذاكرة:

  • وفقًا لـ [SWS_CM_00087] في AUTOSAR_AP_SWS_CommunicationManagement §7.5.12 «Service proxy destruction»، يجب قبل تدمير وكيل الخدمة (Service-Proxy) تحرير جميع ara::com::SamplePtr التي تم توفيرها مسبقًا عبر GetNewSamples()، وذلك لتجنب المراجع المعلقة إلى بيانات عينات الأحداث (Event-Sample).
  • ويصيغ [SWS_CM_00085] التزامًا مشابهًا قبل إلغاء الاشتراك في الأحداث أو الحقول (Unsubscription).

تفسير: من المرجح أن يكون الاستدعاء الصريح لـ 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#7415c458
Content hash
7415c458
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#72e49d87
Content hash
72e49d87
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#ceb5f1c8
Content hash
ceb5f1c8
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#0859ded8
Content hash
0859ded8
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#c07446f5
Content hash
c07446f5
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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: 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: مرجع إلى مثيل آخر من ara::com::SamplePtr، يُستبدل كائنه المُدار بذلك الخاص بـ *this ([SWS_CM_11544]).

لا تمتلك الطريقة أي قيمة إرجاع (void) ([SWS_CM_11544]).

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

تم الإعلان عن التوقيع باستخدام noexcept وتصنيفه على أنه آمن من الاستثناءات (exception safe) ([SWS_CM_11544]). لا يطلق الاستدعاء أي استثناءات ولا يُرجع أي رموز أخطاء.

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

نظرًا لأن Swap تغير حالة كائنين (*this وother) في الوقت نفسه، يُرجّح ألا تكون الاستدعاءات المتوازية على واحد على الأقل من المثيلات المشاركة آمنة بالنسبة للخيوط (thread-safe) دون مزامنة خارجية. سؤال 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#7d79a58e
Content hash
7d79a58e
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#4af911aa
Content hash
4af911aa
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#9750f15e
Content hash
9750f15e
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#95bff3c0
Content hash
95bff3c0
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#cd47c52b
Content hash
cd47c52b
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#7e8d48b2
Content hash
7e8d48b2
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#d58be046
Content hash
d58be046
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#20c17ece
Content hash
20c17ece
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