DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DiagSovdErrorDomain

[SWS_DM_01809] Upstream: RS_AP_00119

class DiagSovdErrorDomain final :                public ara::core::ErrorDomain {...};

Error domain for errors originating from SOVD.

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag
Basisklasse(n)ara::core::ErrorDomain
Unique IDAs per ara::diag::DiagSovdErrorDomain in [SWS_CORE_90023]

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

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

يحدد نطاق الخطأ للتعرف على الأخطاء من SOVD وترجمتها نصياً ومعالجتها بالاستثناءات.

تغلّف الفئة ara::diag::DiagSovdErrorDomain نطاق الخطأ القياسي لأخطاء تشخيص SOVD المحددة ضمن AUTOSAR Adaptive Platform ([SWS_DM_01809]). ومن خلال دوال عناصرها الآمنة خيوطياً، تتيح الترجمة الموثوقة لرموز الأخطاء الرقمية إلى رسائل نصية بالإضافة إلى الإطلاق المحكوم لأنواع استثناءات C++ المناسبة ([SWS_DM_01814]). وإذا كانت استثناءات C++ معطلة في سلسلة أدوات المترجم، فإن دالة إطلاق الاستثناء لا تشارك، وفقاً للقواعد، في مطابقة التحميل الزائد (Overload Resolution).

السياق

يمثل الصنف ara::diag::DiagSovdErrorDomain مجال الخطأ المحدد لحالات الخطأ الناتجة عن النظام الفرعي لـ SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_01809]، AUTOSAR_AP_SWS_Diagnostics §8.51.3 «Class: DiagSovdErrorDomain»). وبصفته تخصيصًا نهائيًا لصنف البنية التحتية الأساسي ara::core::ErrorDomain، فإنه يدمج رموز الأخطاء ومعالجات الاستثناءات المرتبطة بها في سياق SOVD بسلاسة داخل نموذج الخطأ الموحد لـ AUTOSAR Adaptive Platform ([SWS_DM_01809]).

لأغراض التعريف المعياري، توفر دالة العضو Name() الاسم المختصر (ApApplicationErrorDomain.SN) لمجال الخطأ وفقًا لـ [SWS_CORE_90023] ([SWS_DM_01813]، AUTOSAR_AP_SWS_Diagnostics §8.51.3 «Class: DiagSovdErrorDomain»). بالإضافة إلى ذلك، يحدد الصنف اسمين بديلين مركزيين للنوع في نطاق الأسماء الخاص به: يعمل Errc كاسم بديل للتعداد الأساسي DiagSovdErrc ([SWS_DM_01810]، AUTOSAR_AP_SWS_Diagnostics §8.51.3.1.1 «Type Alias: Errc») ويمثل Exception صنف الاستثناء الأساسي المرتبط DiagSovdException ([SWS_DM_01811]، AUTOSAR_AP_SWS_Diagnostics §8.51.3.1.2 «Type Alias: Exception»). عمليًا، يتم الوصول إلى المجال في الغالب عبر الدالة الحرة ara::diag::GetDiagSovdErrorDomain ([SWS_DM_01816]، AUTOSAR_AP_SWS_Diagnostics §8.51.2.1.1 «GetDiagSovdErrorDomain»).

دورة الحياة

يتم إنشاء مثيل من ara::diag::DiagSovdErrorDomain عبر المنشئ الافتراضي الخالي من المعاملات constexpr DiagSovdErrorDomain() noexcept ([SWS_DM_01812]، AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.1.1 «Default Constructor»). بفضل تحديده كـ constexpr وnoexcept، فإن الإنشاء مضمون بأنه آمن من الاستثناءات ويمكن أن يتم بالفعل في وقت الترجمة أو أثناء التهيئة الثابتة. تفسير: من المرجح أن توفير المنشئ constexpr يتيح للمنصة الاحتفاظ بمثيل أحادي (Singleton) طويل العمر يُشار إليه عبر GetDiagSovdErrorDomain ([SWS_DM_01816]). سؤال Q-777076a993f1202d (مفتوح)

فيما يتعلق بالتزامن، تم التصريح عن كافة دوال الأعضاء في الصنف صراحةً بأنها آمنة مؤشريًا ("thread-safe"). ينطبق هذا على المنشئ ([SWS_DM_01812]) وكذلك على عمليات القراءة Name() ([SWS_DM_01813]) وMessage() ([SWS_DM_01814])، بالإضافة إلى إطلاق الاستثناءات عبر ThrowAsException() ([SWS_DM_01815]). بالتالي، يمكن لعدة خيوط معالجة العمل بالتوازي على نفس مثيل المجال دون آليات مزامنة خارجية.

مسار الاستخدام

ينقسم المسار المعتاد لاستخدام ara::diag::DiagSovdErrorDomain إلى الخطوات التالية:

  • الحصول على المجال: يحصل المتصلون على مرجع لمجال الخطأ عادةً عبر الدالة العامة ara::diag::GetDiagSovdErrorDomain ([SWS_DM_01816]، AUTOSAR_AP_SWS_Diagnostics §8.51.2.1.1 «GetDiagSovdErrorDomain») أو ينشئون مثيلًا خاصًا بهم عند الحاجة عبر المنشئ الافتراضي ([SWS_DM_01812]).
  • الاستعلام عن رسالة الخطأ: لترجمة رمز خطأ رقمي من النوع ara::core::ErrorDomain::CodeType (المطابق لـ Errc وفقًا لـ [SWS_DM_01810]) إلى نص قابل للقراءة، يتم استدعاء Message(errorCode) ([SWS_DM_01814]، AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.1 «Message»). تُرجع الدالة مؤشرًا ثابتًا إلى سلسلة نصية (const char*)، والذي يُضمن ألا يكون nullptr أبدًا ([SWS_DM_01814]). تفسير: من المرجح أن تكون السلاسل النصية الناتجة عبارة عن ثوابت حرفية ثابتة (static literals)، نظرًا لأن الدالة مصنفة كـ noexcept. سؤال Q-9af1f4094bda4bde (مفتوح)
  • معالجة الاستثناءات: إذا كان ينبغي نشر حالة خطأ بديلًا عن ذلك عبر استثناءات C++‎، يُمرر التطبيق مثيل ara::core::ErrorCode إلى ThrowAsException(errorCode) ([SWS_DM_01815])، مما يؤدي إلى إطلاق استثناء مطابق للنوع من النوع Exception (DiagSovdException) ([SWS_DM_01811]).
تفاعل نموذجي لحل الأخطاء ومعالجة الاستثناءاتالتطبيقara::diag::GetDiagSovdErrorDomainara::diag::DiagSovdErrorDomainGetDiagSovdErrorDomain()const ara::core::ErrorDomain&Message(errorCode)const char* (Fehlertext)optاستثناءات C++ مفعّلة وتصعيد الخطأ مطلوبThrowAsException(errorCode)throw DiagSovdException

مخطط التسلسل: تسلسل التفاعل النموذجي لحل أوصاف الأخطاء والإطلاق الاختياري للاستثناءات عبر مجال الخطأ. المصادر: [SWS_DM_01814]، [SWS_DM_01815]، [SWS_DM_01816].

سيناريوهات الأخطاء

في إطار معالجة الأخطاء، تُظهر واجهة ara::diag::DiagSovdErrorDomain خصائص سلوكية محددة:

  • إرجاع مضمون للنص: تم التصريح عن الدالة Message بأنها noexcept وهي آمنة تمامًا من الاستثناءات ("exception safe") ([SWS_DM_01814]). لا تفشل أبدًا وتُرجع دائمًا سلسلة نصية صالحة وغير فارغة ([SWS_DM_01814]).
  • إطلاق مستهدف للاستثناءات: الدالة ThrowAsException مخصصة لرمي الاستثناءات، وبالتالي فهي مزودة بـ noexcept(false) بالإضافة إلى التصنيف "not exception safe" ([SWS_DM_01815]). وتطلق، اعتمادًا على ara::core::ErrorCode المُمرر، الاستثناء المقابل من النوع Exception (DiagSovdException) ([SWS_DM_01811]، [SWS_DM_01815]).
  • تعطيل استثناءات C++‎: وفقًا لـ [SWS_CORE_10304]، لا تشارك ThrowAsException في حل التحميل الزائد إذا تم تعطيل استثناءات C++‎ في سلسلة أدوات المترجم ([SWS_DM_01815]). في مثل هذه البيئات، لا تكون الدالة متاحة، ويجب تقييم الأخطاء إلزاميًا عبر رموز الأخطاء.

يستند هذا الدليل حصريًا إلى متطلبات مواصفات وحدة AUTOSAR المعنونة diag (الإصدار R25-11).

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

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

1
DiagSovdErrorDomain

الدوال الأعضاء

3
MessageNameThrowAsException

أسماء الأنواع البديلة

2
ErrcException

مخطط الفئة

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

G nara__diag__DiagSovdErrorDomain991 DiagSovdErrorDomain + DiagSovdErrorDomain() + Message() + Name() + ThrowAsException() nara__core__ErrorDomain335 ErrorDomain nara__diag__DiagSovdErrorDomain991->nara__core__ErrorDomain335

عرض التفاصيل

اختر عنصرًا من المخطط.

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

DiagSovdErrorDomain دالة

Default constructor.

constexpr DiagSovdErrorDomain () noexcept;

الدوال الأعضاء

Message دالة

Translate an error code value into a text message.

const char * Message (ara::core::ErrorDomain::CodeType errorCode) const noexcept override;
Name دالة

Return the "shortname" ApApplicationErrorDomain.SN of this error domain.

const char * Name () const noexcept override;
ThrowAsException دالة

Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.

void ThrowAsException (const ara::core::ErrorCode &errorCode) const noexcept(false) override;

أسماء الأنواع البديلة

Errc اسم نوع بديل

Alias for the error code value enumeration.

using Errc = DiagSovdErrc;
Exception اسم نوع بديل

Alias for the exception base class.

using Exception = DiagSovdException;

توثيق الدوال

دالة DiagSovdErrorDomain [SWS_DM_01812] Upstream: RS_AP_00119

constexpr DiagSovdErrorDomain () noexcept;

Default constructor.

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

الاستخدام

تهيئ الدالة الإنشائية الافتراضية حالة من نطاق الخطأ ara::diag::DiagSovdErrorDomain [SWS_DM_01812] وفقاً لـ AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.1.1 «Default Constructor». وأُعلن عن الدالة بأنها constexpr وnoexcept وتتطلب تضمين ملف الرأس #include "ara/diag/diag_sovd_error_domain.h" [SWS_DM_01812].

التفاعل وسياق الاستدعاء

في سيناريوهات التطبيق النموذجية، يُرجح أن التوليد اليدوي المباشر للحالات عبر هذه الدالة الإنشائية نادراً ما يكون مطلوباً، نظراً لأن الواجهة الوظيفية ara::diag::GetDiagSovdErrorDomain() توفر بالفعل مرجعاً للحالة العامة لنطاق الخطأ [SWS_DM_01816]. سؤال Q-8c4b22173b01dce7 (مفتوح)

تحدد الفئة DiagSovdErrorDomain نطاق الخطأ لـ SOVD وتوفر الأنواع والدوال الأساسية:

  • أسماء مستعارة للأنواع لرموز الخطأ Errc [SWS_DM_01810] ومعالجة الاستثناءات Exception [SWS_DM_01811].
  • إنشاء حالات رموز الخطأ عبر MakeErrorCode() [SWS_DM_01817].
  • الاستعلام عن الاسم عبر Name() [SWS_DM_01813] وترجمة النص عبر Message() [SWS_DM_01814] بالإضافة إلى إثارة الاستثناءات عبر ThrowAsException() [SWS_DM_01815].

معالجة الأخطاء والتزامن

كدالة noexcept بدون معلمات، لا يطلق المُنشئ أية استثناءات. وفقًا للمواصفة، فإن الاستدعاء آمن من حيث الاستثناءات («exception safe») وآمن تفرعيًا بشكل متزامن («thread-safe») [SWS_DM_01812]. لا توجد شروط مسبقة أو رموز خطأ محددة معرّفة للمُنشئ.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويُستخدم لتكملة التوثيق.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Scopeclass ara::diag::DiagSovdErrorDomain
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_01812
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01812@rel:R25-11#5fd6f279
Content hash
5fd6f279
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01812
Status: valid/unmigrated Version: rel:R25-11#9902f400 Versionshistorie & Revisions (1 transition, 4 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_DM_01812@rel:R25-11#9902f400
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#0ace1d492026-09-30
  • R23-11rel:R23-11#c4e261b62026-10-14
  • R24-11rel:R24-11#17b155a72026-10-14
  • R25-11rel:R25-11#9902f4002026-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

دالة Message [SWS_DM_01814] Upstream: RS_AP_00119

const char * Message (ara::core::ErrorDomain::CodeType errorCode) const noexcept override;

Translate an error code value into a text message.

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

تُستخدم دالة العضو Message للفئة ara::diag::DiagSovdErrorDomain للترجمة المتزامنة لرمز خطأ رقمي إلى رسالة نصية قابلة للقراءة [SWS_DM_01814] (مُثبت في AUTOSAR_AP_SWS_Diagnostics ص. 69). ويتم توفيرها عبر ملف الترويسة ara/diag/diag_sovd_error_domain.h في مساحة الاسم ara::diag.

تنطبق ميزات المواصفة التالية على الاستدعاء وسلوك وقت التشغيل:

  • الاستخدام والدلالات: كمعلمة إدخال، يتم تمرير errorCode من النوع ara::core::ErrorDomain::CodeType. تُعيد الدالة بشكل متزامن مؤشرًا إلى سلسلة نصية ثابتة (const char *) تحتوي على الوصف النصي للخطأ. تضمن المواصفة بشكل ملزم ألا تكون قيمة الإرجاع هذه أبدًا nullptr [SWS_DM_01814].
  • معالجة الأخطاء والمتانة: الواجهة مؤهلة بـ noexcept ومحددة بأنها آمنة للاستثناءات (exception safe) [SWS_DM_01814]. لا يتم إطلاق أي استثناءات C++. تفسير: عند تمرير رمز خطأ غير معرف أو غير معروف، يُرجّح أن يُعيد التنفيذ نصًا إرشاديًا موحدًا للوفاء بضمان عدم وجود مؤشر فارغ. سؤال Q-c115f3da24bde8bd (مفتوح)
  • التزامن: تم الإعلان عن الطريقة كعملية const وتحديدها صراحةً بأنها آمنة للسلاسل (thread-safe) [SWS_DM_01814]. وهي لا تُعدل أي حالات داخلية، ولا تخضع لشروط الترتيب، ويمكن استدعاؤها بالتوازي من عدة سلاسل عمليات دون أقفال خارجية أو آليات مزامنة.
  • التفاعل في إدارة التشخيص: توفر الطريقة الترجمة النصية القياسية لنطاق أخطاء SOVD. وتتبع النمط المعماري الموحد لـ Adaptive Platform وتطابق في التوقيع والسلوك تطبيقات Message لنطاقات أخطاء التشخيص ذات الصلة مثل DiagErrorDomain [SWS_DM_00522]، وDiagUdsNrcErrorDomain [SWS_DM_00534]، وDiagOfferErrorDomain [SWS_DM_00994]، وDiagReportingErrorDomain [SWS_DM_01001].

تم توليد ملاحظة الاستخدام هذه تلقائياً بناءً على المواصفة.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Scopeclass ara::diag::DiagSovdErrorDomain
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
errorCodethe error code value

Rückgabewert

TypBeschreibung
const char *the text message, never nullptr

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

Record
AUTOSAR/AP/record/SWS_DM_01814
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01814@rel:R25-11#9926981a
Content hash
9926981a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01814
Status: valid/unmigrated Version: rel:R25-11#ffbd0e80 Versionshistorie & Revisions (1 transition, 4 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_DM_01814@rel:R25-11#ffbd0e80
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#82b505e52026-09-30
  • R23-11rel:R23-11#f2dfd27e2026-10-14
  • R24-11rel:R24-11#ffbd0e802026-10-14
  • R25-11rel:R25-11#ffbd0e802026-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

دالة Name [SWS_DM_01813] Upstream: RS_AP_00119

const char * Name () const noexcept override;

Return the "shortname" ApApplicationErrorDomain.SN of this error domain.

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

الاستخدام

تُعيد الطريقة Name للفئة ara::diag::DiagSovdErrorDomain الاسم القصير (ApApplicationErrorDomain.SN) لنطاق أخطاء SOVD بشكل متزامن كسلسلة نصية بتنسيق C (const char*) ([SWS_DM_01813]؛ AUTOSAR_AP_SWS_Diagnostics §7 «Diagnostics»). لا تتوقع الدالة أي معلمات مُمررة ويتم توفيرها عبر ملف الترويسة ara/diag/diag_sovd_error_domain.h ([SWS_DM_01813]). تفسير: يُرجّح أن يشير المؤشر المُرجع إلى سلسلة نصية ثابتة وغير قابلة للتغيير، تظل صالحة طوال وقت التشغيل بأكمله. سؤال Q-b7b74a09ea645e46 (مفتوح)

معالجة الأخطاء والتزامن

تم الإعلان عن الدالة كـ noexcept وتعتبر آمنة للاستثناءات (exception safe) ([SWS_DM_01813]). وهي لا تبلغ عن أي رموز خطأ ولا تُنشئ أي إدخالات DET أو DEM. بالنسبة للتزامن، تم تحديد الطريقة على أنها آمنة للسلاسل (thread-safe) ([SWS_DM_01813]). وبالتالي فهي تمتلك خصائص قابلة لإعادة الدخول (reentrant) ويمكن استدعاؤها من أي سلاسل عمليات دون آليات مزامنة خارجية.

تفاعل

تتبع الواجهة نمط الاستعلام الموحد عن الأسماء لنطاقات الأخطاء في التشخيص التكيفي. وتوجد تطبيقات مطابقة في ara::diag::DiagErrorDomain ([SWS_DM_00521])، وara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533])، وara::diag::DiagOfferErrorDomain ([SWS_DM_00993])، وكذلك ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]). وتُستخدم عادةً للتسجيل وتحديد نطاقات الأخطاء في سياق SOVD.

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا وتستند إلى مواصفة AUTOSAR Adaptive Platform R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Scopeclass ara::diag::DiagSovdErrorDomain
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
const char *As per ara::diag::DiagSovdErrorDomain in [SWS_CORE_ 90023]

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

Record
AUTOSAR/AP/record/SWS_DM_01813
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01813@rel:R25-11#ed0ec04b
Content hash
ed0ec04b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01813
Status: valid/unmigrated Version: rel:R25-11#677ee3b1 Versionshistorie & Revisions (1 transition, 4 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_DM_01813@rel:R25-11#677ee3b1
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#75e084072026-09-30
  • R23-11rel:R23-11#91f360a72026-10-14
  • R24-11rel:R24-11#1d9d4d622026-10-14
  • R25-11rel:R25-11#677ee3b12026-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

دالة ThrowAsException [SWS_DM_01815] Upstream: RS_AP_00119

void ThrowAsException (const ara::core::ErrorCode &errorCode) const noexcept(false) override;

Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.

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

الاستخدام

تُستخدم الطريقة ThrowAsException للفئة ara::diag::DiagSovdErrorDomain ([SWS_DM_01815]، المعلنة في ملف الترويسة ara/diag/diag_sovd_error_domain.h؛ انظر AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.3 «ThrowAsException») لتحويل رمز خطأ بشكل متزامن إلى نوع استثناء C++ المقترن به. وتقبل معلمة الإدخال errorCode من النوع const ara::core::ErrorCode & وليس لها قيمة إرجاع (void). عند الاستدعاء، فإنها تطلق الاستثناء المقابل لرمز الخطأ وفقًا للتوقيع مع noexcept(false).

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

تصنف المواصفة الطريقة بأنها «not exception safe» ([SWS_DM_01815]). تفسير: يُرجّح أن يستند هذا التصنيف إلى حقيقة أن رمي الاستثناء المتعمد يؤدي إلى مغادرة مسار التحكم العادي. سؤال Q-23924e13760f4186 (مفتوح) يتعلق شرط حافة أساسي بسلسلة أدوات المترجم: وفقًا لـ [SWS_CORE_10304]، لا يشارك ThrowAsException في حل التحميل الزائد إذا تم تعطيل استثناءات C++ في المترجم.

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

تم تصنيف الدالة على أنها آمنة للسلاسل (thread-safe) ([SWS_DM_01815]) وتسمح بالاستدعاء المتزامن. ويتبع السلوك المخطط القياسي لنطاقات أخطاء التشخيص في الوحدة DM. وتنطبق تعريفات مماثلة على ara::diag::DiagErrorDomain ([SWS_DM_00523]، انظر AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 «ThrowAsException»)، وara::diag::DiagOfferErrorDomain ([SWS_DM_00995]، انظر AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 «ThrowAsException»)، وara::diag::DiagReportingErrorDomain ([SWS_DM_01002]، انظر AUTOSAR_AP_SWS_Diagnostics §8.11.7.2.2.3 «ThrowAsException»)، وكذلك ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535]، انظر AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException»).

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفات AUTOSAR Release R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Scopeclass ara::diag::DiagSovdErrorDomain
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
errorCodethe ErrorCode instance

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_01815
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01815@rel:R25-11#e79f114d
Content hash
e79f114d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01815
Status: valid/unmigrated Version: rel:R25-11#975d8ee0 Versionshistorie & Revisions (1 transition, 4 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_DM_01815@rel:R25-11#975d8ee0
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#2fdaf0712026-09-30
  • R23-11rel:R23-11#1a45209e2026-10-14
  • R24-11rel:R24-11#57b430f42026-10-14
  • R25-11rel:R25-11#975d8ee02026-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

توثيق أسماء الأنواع البديلة

اسم نوع بديل Errc [SWS_DM_01810] Upstream: RS_AP_00119

using Errc = DiagSovdErrc;

Alias for the error code value enumeration.

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Scopeclass ara::diag::DiagSovdErrorDomain
SymbolErrc

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

Record
AUTOSAR/AP/record/SWS_DM_01810
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01810@rel:R25-11#991e52c8
Content hash
991e52c8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01810
Status: valid/unmigrated Version: rel:R25-11#8846b3aa Versionshistorie & Revisions (1 transition, 4 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_DM_01810@rel:R25-11#8846b3aa
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b173fbe82026-09-30
  • R23-11rel:R23-11#8846b3aa2026-10-14
  • R24-11rel:R24-11#8846b3aa2026-10-14
  • R25-11rel:R25-11#8846b3aa2026-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

اسم نوع بديل Exception [SWS_DM_01811] Upstream: RS_AP_00119

using Exception = DiagSovdException;

Alias for the exception base class.

Header-Datei#include "ara/diag/diag_sovd_error_domain.h"
Scopeclass ara::diag::DiagSovdErrorDomain
SymbolException

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

Record
AUTOSAR/AP/record/SWS_DM_01811
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01811@rel:R25-11#a2033848
Content hash
a2033848
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01811
Status: valid/unmigrated Version: rel:R25-11#afe352e2 Versionshistorie & Revisions (1 transition, 4 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_DM_01811@rel:R25-11#afe352e2
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#1c571c472026-09-30
  • R23-11rel:R23-11#afe352e22026-10-14
  • R24-11rel:R24-11#afe352e22026-10-14
  • R25-11rel:R25-11#afe352e22026-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