DEENESPTFRRUARHIKOZHNL

فئة ara::core::CoreErrorDomain

[SWS_CORE_05221] Upstream: RS_AP_00130

class CoreErrorDomain final :             public ErrorDomain {...};

An error domain for errors originating from the ara::core Functional Cluster.

Header-Datei#include "ara/core/core_error_domain.h"
Forwarding-Header#include "ara/core/core_fwd.h"
Scopenamespace ara::core
Basisklasse(n)ErrorDomain
Unique IDAs per ara::core::CoreErrorDomain in [SWS_CORE_90023]

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

يدير رموز الأخطاء الخاصة بالحزمة الوظيفية (cluster) ara::core، ويترجمها إلى رسائل خطأ، ويطلق الاستثناءات المرتبطة بها.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 8500dff6850e المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يدير رموز الأخطاء الخاصة بالحزمة الوظيفية (cluster) ara::core، ويترجمها إلى رسائل خطأ، ويطلق الاستثناءات المرتبطة بها.

يمثل الصنف ara::core::CoreErrorDomain نطاق الخطأ للأخطاء الصادرة من الحزمة الوظيفية ara::core، ويقرن رموز الأخطاء العددية برسائل نصية وصفية [SWS_CORE_05243]. علاوة على ذلك، يتيح عبر ThrowAsException() تحويل رموز الأخطاء إلى استثناءات CoreException خاصة بالنوع [SWS_CORE_05244]. ونظراً لأن جميع دوال الاستعلام آمنة بالنسبة للخيوط (thread-safe) وقابلة للإنشاء بواسطة constexpr، فإن هذا النطاق يعد مناسباً للاستخدام عالي الكفاءة على مستوى الحزمة بالكامل. وإذا كانت استثناءات C++‎ معطلة في حزمة الأدوات (toolchain)، فإن دالة الاستثناء لا تشارك في مطابقة التحميل الزائد (overload resolution).

السياق

يمثل الصنف ara::core::CoreErrorDomain نطاق الخطأ المحدد لجميع حالات الخطأ التي تنشأ في الحزمة الوظيفية ara::core. وهو معرّف كتخصيص نهائي (final) من ErrorDomain، مما يمنع أي اشتقاق إضافي منه. يتيح الصنف عبر الدالة Name() الاسم القصير الفريد للنطاق [SWS_CORE_05242]. ولتحقيق تكامل متناسق مع نموذج معالجة الأخطاء في AUTOSAR، يعرّف CoreErrorDomain أسماء مستعارة مركزية للأنواع (type aliases): يشير Errc كاسم مستعار مباشرة إلى التعداد CoreErrc [SWS_CORE_05231]، بينما يشكل Exception الاسم المستعار لصنف الاستثناء الأساسي المرتبط CoreException [SWS_CORE_05232]. وتشتمل أهم أطراف التفاعل على كبسولات الأخطاء العامة من النوع ErrorCode، والتي تحتفظ بمرجع إلى نطاق الخطأ المعني، بالإضافة إلى المكونات المنفّذة التي تشخص حالات الخطأ أو تعالجها.

دورة الحياة

يتم إنشاء كائن CoreErrorDomain عبر المنشئ الافتراضي الخالي من المعاملات constexpr CoreErrorDomain() noexcept [SWS_CORE_05241]. وبما أن المنشئ مصرّح به كـ constexpr وnoexcept، فإنه يمكن إنشاء المثيل أثناء وقت الترجمة دون أي عبء تخصيص للذاكرة أو خطر إطلاق استثناء.

تفسير: نظراً لأن نطاقات الخطأ في معيار AUTOSAR Adaptive مصممة لتكون عديمة الحالة (stateless) وتوفر حصراً بيانات وصفية ثابتة بالإضافة إلى منطق التحويل، فمن المتوقع عادةً وجود مثيل مفرد (singleton) عام أو ساكن في النظام يتم الوصول إليه على مستوى الحزمة بأكملها. سؤال Q-7b4761bf124c5755 (مفتوح) يظل المثيل صالحاً طوال فترة تشغيل العملية بأكملها. وفيما يتعلق بالتزامن، تم تحديد عمليات الصنف بأنها آمنة بالنسبة للخيوط [SWS_CORE_05241]، [SWS_CORE_05242]، [SWS_CORE_05243]، مما يسمح بالاستعلام المتزامن من خيوط متوازية متعددة دون تدابير مزامنة إضافية.

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

أثناء التشغيل الفعلي، يتم الرجوع إلى CoreErrorDomain بشكل أساسي في سيناريوهين نموذجيين بواسطة نظام وقت التشغيل أو كود التطبيق: لفحص الأخطاء نصياً ولمعالجة الاستثناءات.

عند حدوث خطأ، يمكن الاستعلام عن الرسالة النصية المرتبطة به عبر الدالة العضو Message() عن طريق تمرير رمز الخطأ العددي [SWS_CORE_05243]. وتضمن المواصفة بشكل ملزم ألا تُرجع هذه الدالة مؤشراً فارغاً (nullptr) أبداً، بحيث يمكن استخدام const char* المُرجع بأمان لمخرجات التشخيص أو تسجيل الأحداث (logging). وإذا لم يكن المطلوب معالجة الخطأ كقيمة إرجاع بل تعميمه كاستثناء C++‎، يُستخدم لهذا الغرض التابع ThrowAsException() [SWS_CORE_05244]. يستقبل هذا التابع مثيلاً من ErrorCode، وينشئ كائن CoreException المطابق ويطلقه في مكدس الاستدعاءات الحالي.

الاستعلام عن نص الخطأ وإطلاق الاستثناء عبر CoreErrorDomainالتطبيقCoreErrorDomainCoreExceptionMessage(errorCode)Textmeldung (never nullptr)Use Case: AusnahmebehandlungoptC++ Exceptions aktiviertThrowAsException(errorCode)wirft CoreException(errorCode)

مخطط تسلسلي: المسار النموذجي لترجمة رموز الأخطاء وإطلاق الاستثناءات المشروط. المصادر: [SWS_CORE_05243]، [SWS_CORE_05244]

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

تم التصريح عن الدالتين Name() وMessage() بالإضافة إلى المنشئ بأنها noexcept، كما تم تصنيفها بأنها آمنة من الاستثناءات (exception safe) [SWS_CORE_05241]، [SWS_CORE_05242]، [SWS_CORE_05243]. وهي لا تطلق استثناءات حتى في ظل ظروف الخطأ ولا تولد رموز خطأ خاصة بها.

في المقابل، تم تزويد ThrowAsException() صراحةً بـ noexcept(false) وتمييزه بأنه غير آمن من الاستثناءات، نظراً لأن الإطلاق الحتمي لاستثناء (من النوع CoreException) يمثل المهمة الأساسية لهذه الواجهة [SWS_CORE_05244]. ويُعد شرطاً معمارياً مسبقاً أساسياً: إذا تم تعطيل استثناءات C++‎ في حزمة الأدوات المستخدمة أو في إعدادات المترجم، فلا يجوز لهذه الدالة المشاركة في مطابقة التحميل الزائد [SWS_CORE_05244]. يمنع ذلك حدوث أخطاء ترجمة في بيئات الأنظمة التي تتبع نهج الأنظمة المدمجة المتسامحة مع الأخطاء بدون معالجة استثناءات C++‎.

تم توليد هذا الدليل بواسطة نظام ذكاء اصطناعي بناءً على المواصفة R25-11.

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

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

1
CoreErrorDomain

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

3
MessageNameThrowAsException

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

2
ErrcException

مخطط الفئة

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

G nara__core__CoreErrorDomain113 CoreErrorDomain + CoreErrorDomain() + Message() + Name() + ThrowAsException() nara__core__ErrorDomain335 ErrorDomain nara__core__CoreErrorDomain113->nara__core__ErrorDomain335

عرض التفاصيل

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

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

CoreErrorDomain دالة

Default constructor

constexpr CoreErrorDomain () noexcept;

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

Message دالة

Translate an error code value into a text message

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

Return the ApApplicationErrorDomain. shortName of this error domain

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

Throw the exception type corresponding to the given ErrorCode.

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

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

Errc اسم نوع بديل

Alias for the error code value enumeration

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

Alias for the exception base class

using Exception = CoreException;

توثيق الدوال

دالة CoreErrorDomain [SWS_CORE_05241] Upstream: RS_AP_00130

constexpr CoreErrorDomain () noexcept;

Default constructor

Header-Datei#include "ara/core/core_error_domain.h"
Scopeclass ara::core::CoreErrorDomain
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_CORE_05241
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CORE_05241@rel:R25-11#9e5c7586
Content hash
9e5c7586
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Core.pdf#nameddest=SWS_CORE_05241
Status: valid/unmigrated Version: rel:R25-11#3e485a80 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_CORE_05241@rel:R25-11#3e485a80
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b295a3ea2026-09-30
  • R19-11rel:R19-11#070db4fd2026-10-14
  • R20-11rel:R20-11#fbd86c322026-10-14
  • R21-11rel:R21-11#f39944522026-10-14
  • R22-11rel:R22-11#326fb7c62026-10-14
  • R23-11rel:R23-11#5f0eb25d2026-10-14
  • R24-11rel:R24-11#3e485a802026-10-14
  • R25-11rel:R25-11#3e485a802026-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_CORE_05243] Upstream: RS_AP_00130

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

Translate an error code value into a text message

Header-Datei#include "ara/core/core_error_domain.h"
Scopeclass ara::core::CoreErrorDomain
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_CORE_05243
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CORE_05243@rel:R25-11#c00d3374
Content hash
c00d3374
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Core.pdf#nameddest=SWS_CORE_05243
Status: valid/unmigrated Version: rel:R25-11#00427b91 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_CORE_05243@rel:R25-11#00427b91
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#09cacd332026-09-30
  • R19-11rel:R19-11#d12bc2432026-10-14
  • R20-11rel:R20-11#2b2da89e2026-10-14
  • R21-11rel:R21-11#2b2da89e2026-10-14
  • R22-11rel:R22-11#73527d722026-10-14
  • R23-11rel:R23-11#17fa2fc82026-10-14
  • R24-11rel:R24-11#00427b912026-10-14
  • R25-11rel:R25-11#00427b912026-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_CORE_05242] Upstream: RS_AP_00130

const char * Name () const noexcept override;

Return the ApApplicationErrorDomain. shortName of this error domain

Header-Datei#include "ara/core/core_error_domain.h"
Scopeclass ara::core::CoreErrorDomain
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
const char *As per ara::core::CoreErrorDomain in [SWS_CORE_90023]

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

Record
AUTOSAR/AP/record/SWS_CORE_05242
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CORE_05242@rel:R25-11#44f95123
Content hash
44f95123
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Core.pdf#nameddest=SWS_CORE_05242
Status: valid/unmigrated Version: rel:R25-11#1f57e0cc 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_CORE_05242@rel:R25-11#1f57e0cc
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#d99ba5832026-09-30
  • R19-11rel:R19-11#5d1f96f42026-10-14
  • R20-11rel:R20-11#4467617d2026-10-14
  • R21-11rel:R21-11#4467617d2026-10-14
  • R22-11rel:R22-11#11fc29042026-10-14
  • R23-11rel:R23-11#a9c4ef8a2026-10-14
  • R24-11rel:R24-11#347b7dd02026-10-14
  • R25-11rel:R25-11#1f57e0cc2026-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_CORE_05244] Upstream: RS_AP_00130

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

Throw the exception type corresponding to the given ErrorCode.

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

تُستخدم الدالة العضو ThrowAsException للفئة ara::core::CoreErrorDomain (المعرفة في الترويسة ara/core/core_error_domain.h) للإطلاق التزامني لاستثناء C++‎ استنادًا إلى رمز الخطأ الممرّر [SWS_CORE_05244]. وتقبل الدالة كمعلمة مرجعًا إلى مثيل ثابت من ErrorCode (const ErrorCode &errorCode) [SWS_CORE_05244]. ليس للدالة قيمة إرجاع، بل ترمي مباشرةً استثناءً من النوع CoreException، والذي يغلّف كائن ErrorCode الممرّر بالكامل [SWS_CORE_05244].

فيما يتعلق بسياق التنفيذ، والتزامن، وشروط المترجم، تسري المتطلبات التالية:

  • الأمان من حيث خيوط التنفيذ: تم تحديد الدالة بأنها آمنة من حيث خيوط التنفيذ (thread-safe) وبالتالي يمكن استدعاؤها بأمان من سياقات متزامنة [SWS_CORE_05244].
  • الأمان من الاستثناءات: تم تصنيف السلوك رسميًا بأنه غير آمن من الاستثناءات (not exception safe)، نظرًا لأن الدالة مصرّح عنها بـ noexcept(false) وترمي استثناءً بحسب التصميم [SWS_CORE_05244].
  • قيود المترجم: إذا تم تعطيل استثناءات C++‎ في سلسلة أدوات المترجم، فلا يجوز للدالة المشاركة في حل التحميل الزائد وفقًا لـ [SWS_CORE_10304] [SWS_CORE_05244].

في الهيكل المعماري، تتجاوز الدالة (override) الدالة الأساسية الافتراضية البحتة ThrowAsException للفئة المجردة ara::core::ErrorDomain [SWS_CORE_00154]. وفي الاستخدام النموذجي، لا يتم استدعاء الدالة مباشرةً على كائن النطاق، بل يتم إطلاقها عبر الدالة المساعدة ErrorCode::ThrowAsException()، والتي تعيد توجيه الاستدعاء ديناميكيًا عبر this->Domain().ThrowAsException(*this) إلى نطاق الخطأ المسؤول [SWS_CORE_00519].

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

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

Header-Datei#include "ara/core/core_error_domain.h"
Scopeclass ara::core::CoreErrorDomain
Exception-Sicherheitnot exception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
errorCodethe ErrorCode instance

Rückgabewert

TypBeschreibung
None

Exceptions

CoreException an exception containing the given ErrorCode

Hinweise: This function shall not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain. As per [SWS_CORE_10304]

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

Record
AUTOSAR/AP/record/SWS_CORE_05244
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CORE_05244@rel:R25-11#8dafc13f
Content hash
8dafc13f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Core.pdf#nameddest=SWS_CORE_05244
Status: valid/unmigrated Version: rel:R25-11#76549789 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_CORE_05244@rel:R25-11#76549789
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#8be3b2f52026-09-30
  • R19-11rel:R19-11#98ba1eda2026-10-14
  • R20-11rel:R20-11#1103982a2026-10-14
  • R21-11rel:R21-11#52e0dd5c2026-10-14
  • R22-11rel:R22-11#5de8a1b22026-10-14
  • R23-11rel:R23-11#27770af82026-10-14
  • R24-11rel:R24-11#0c81b1e92026-10-14
  • R25-11rel:R25-11#765497892026-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_CORE_05231] Upstream: RS_AP_00130

using Errc = CoreErrc;

Alias for the error code value enumeration

Header-Datei#include "ara/core/core_error_domain.h"
Scopeclass ara::core::CoreErrorDomain
SymbolErrc

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

Record
AUTOSAR/AP/record/SWS_CORE_05231
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CORE_05231@rel:R25-11#064a502d
Content hash
064a502d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Core.pdf#nameddest=SWS_CORE_05231
Status: valid/unmigrated Version: rel:R25-11#c33560a7 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_CORE_05231@rel:R25-11#c33560a7
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#634f14922026-09-30
  • R19-11rel:R19-11#37c73a1f2026-10-14
  • R20-11rel:R20-11#a73623902026-10-14
  • R21-11rel:R21-11#a73623902026-10-14
  • R22-11rel:R22-11#5b6e63892026-10-14
  • R23-11rel:R23-11#f478ff612026-10-14
  • R24-11rel:R24-11#c33560a72026-10-14
  • R25-11rel:R25-11#c33560a72026-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_CORE_05232] Upstream: RS_AP_00130

using Exception = CoreException;

Alias for the exception base class

Header-Datei#include "ara/core/core_error_domain.h"
Scopeclass ara::core::CoreErrorDomain
SymbolException

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

Record
AUTOSAR/AP/record/SWS_CORE_05232
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CORE_05232@rel:R25-11#48d951f4
Content hash
48d951f4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Core.pdf#nameddest=SWS_CORE_05232
Status: valid/unmigrated Version: rel:R25-11#5d1bfae3 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_CORE_05232@rel:R25-11#5d1bfae3
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#9c108ed52026-09-30
  • R19-11rel:R19-11#d33d63502026-10-14
  • R20-11rel:R20-11#907e01392026-10-14
  • R21-11rel:R21-11#907e01392026-10-14
  • R22-11rel:R22-11#3eaa58ca2026-10-14
  • R23-11rel:R23-11#bdda71cf2026-10-14
  • R24-11rel:R24-11#5d1bfae32026-10-14
  • R25-11rel:R25-11#5d1bfae32026-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