DEENESPTFRRUARHIKOZHNL

class 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]

User GuideKI-GENERIERT

Verwaltet Fehlercodes des Clusters ara::core, übersetzt sie in Fehlermeldungen und wirft zugehörige Ausnahmen.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 8500dff6850e Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwaltet Fehlercodes des Clusters ara::core, übersetzt sie in Fehlermeldungen und wirft zugehörige Ausnahmen.

Die Klasse ara::core::CoreErrorDomain repräsentiert die Fehlerdomäne für Fehler aus dem funktionalen Cluster ara::core und ordnet numerischen Fehlercodes beschreibende Textmeldungen zu [SWS_CORE_05243]. Zudem ermöglicht sie über ThrowAsException() die Überführung von Fehlercodes in typspezifische CoreException-Ausnahmen [SWS_CORE_05244]. Da alle abfragenden Methoden threadsicher und constexpr-konstruierbar sind, eignet sich die Domäne für den effizienten clusterweiten Einsatz. Sind C++-Ausnahmen in der Toolchain deaktiviert, nimmt die Ausnahmemethode nicht an der Überladungsauflösung teil.

Kontext

Die Klasse ara::core::CoreErrorDomain repräsentiert die spezifische Fehlerdomäne für alle Fehlerzustände, die ihren Ursprung im funktionalen Cluster ara::core haben. Sie ist als finale Spezialisierung von ErrorDomain definiert und verhindert damit eine weitere Ableitung. Die Klasse stellt über die Methode Name() den eindeutigen Kurznamen der Domäne bereit [SWS_CORE_05242]. Für eine konsistente Integration in das AUTOSAR-Fehlerbehandlungsmodell definiert CoreErrorDomain zentrale Typaliase: Errc verweist als Alias direkt auf die Aufzählung CoreErrc [SWS_CORE_05231], während Exception den Alias für die zugehörige Basisausnahmeklasse CoreException bildet [SWS_CORE_05232]. Zu den wichtigsten Interaktionspartnern gehören die generischen Fehlerkapseln vom Typ ErrorCode, welche eine Referenz auf die jeweilige Fehlerdomäne halten, sowie ausführende Komponenten, die Fehlerzustände diagnostizieren oder behandeln.

Lebenszyklus

Die Erzeugung einer CoreErrorDomain erfolgt über den parameterlosen Standardkonstruktor constexpr CoreErrorDomain() noexcept [SWS_CORE_05241]. Da der Konstruktor als constexpr und noexcept deklariert ist, kann die Instanz bereits zur Übersetzungszeit ohne Allokationsaufwand oder Ausnahmegefahr erzeugt werden.

Interpretation: Da Fehlerdomänen im AUTOSAR-Adaptive-Standard zustandslos konzipiert sind und ausschließlich konstante Metadaten sowie Transformationslogik bereitstellen, dürfte typischerweise eine globale oder statische Singleton-Instanz im System existieren, auf die clusterweit zugegriffen wird. Frage Q-7b4761bf124c5755 (offen) Die Instanz bleibt über die gesamte Laufzeit des Prozesses hinweg gültig. Hinsichtlich der Nebenläufigkeit sind die Operationen der Klasse als threadsicher spezifiziert [SWS_CORE_05241], [SWS_CORE_05242], [SWS_CORE_05243], wodurch gleichzeitige Abfragen aus mehreren parallelen Threads ohne zusätzliche Synchronisationsmaßnahmen erlaubt sind.

Nutzungspfad

Im laufenden Betrieb wird CoreErrorDomain vor allem in zwei typischen Szenarien durch das Laufzeitsystem oder Anwendungscode konsultiert: zur textuellen Fehlerinspektion und zur Ausnahmebehandlung.

Liegt ein aufgetretener Fehler vor, kann über die Elementfunktion Message() unter Übergabe des numerischen Fehlercodes die zugehörige Textnachricht abgefragt werden [SWS_CORE_05243]. Die Spezifikation sichert verbindlich zu, dass diese Funktion niemals einen Nullzeiger (nullptr) liefert, sodass der zurückgegebene const char* gefahrlos für Diagnoseausgaben oder Protokollierung verwendet werden kann. Soll ein Fehler nicht als Rückgabewert behandelt, sondern als C++-Ausnahme propagiert werden, dient hierzu die Methode ThrowAsException() [SWS_CORE_05244]. Diese nimmt eine ErrorCode-Instanz entgegen, instanziiert die korrespondierende CoreException und wirft diese in den aktuellen Aufrufstapel.

Fehlertext-Abfrage und Ausnahmeauslösung über CoreErrorDomainAnwendungCoreErrorDomainCoreExceptionMessage(errorCode)Textmeldung (never nullptr)Use Case: AusnahmebehandlungoptC++ Exceptions aktiviertThrowAsException(errorCode)wirft CoreException(errorCode)

Sequenzdiagramm: Typischer Ablauf zur Übersetzung von Fehlercodes und bedingten Auslösung von Ausnahmen. Quellen: [SWS_CORE_05243], [SWS_CORE_05244]

Fehlerszenarien

Die Funktionen Name() und Message() sowie der Konstruktor sind als noexcept deklariert und als ausnahmesicher eingestuft [SWS_CORE_05241], [SWS_CORE_05242], [SWS_CORE_05243]. Sie werfen selbst unter Fehlerbedingungen keine Ausnahmen und erzeugen keine eigenen Fehlercodes.

Demgegenüber ist ThrowAsException() explizit mit noexcept(false) versehen und als nicht ausnahmesicher gekennzeichnet, da das deterministische Werfen einer Ausnahme (vom Typ CoreException) die primäre Aufgabe dieser Schnittstelle darstellt [SWS_CORE_05244]. Als zentrale architektonische Vorbedingung gilt: Falls in der verwendeten Toolchain bzw. den Compiler-Einstellungen C++-Ausnahmen deaktiviert sind, darf diese Funktion nicht an der Überladungsauflösung teilnehmen [SWS_CORE_05244]. Dies verhindert Kompilierungsfehler in Systemumgebungen, die dem fehlertoleranten Embedded-Ansatz ohne C++-Ausnahmebehandlung folgen.

Dieser Leitfaden wurde durch ein KI-System auf Basis der Spezifikation R25-11 generiert.

Mitgliederkarte

Konstruktoren und Destruktor

1

Typaliase

2

Klassendiagramm

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

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

Default constructor

constexpr CoreErrorDomain () noexcept;

Methoden

Message function

Translate an error code value into a text message

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

Return the ApApplicationErrorDomain. shortName of this error domain

const char * Name () const noexcept override;

Throw the exception type corresponding to the given ErrorCode.

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

Typaliase

Errc type alias

Alias for the error code value enumeration

using Errc = CoreErrc;
Exception type alias

Alias for the exception base class

Dokumentation der Methoden

function 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#b295a3ea
Content hash
b295a3ea
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

function 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#09cacd33
Content hash
09cacd33
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

function 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#d99ba583
Content hash
d99ba583
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

function 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.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c5a4846a6615 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Elementfunktion ThrowAsException der Klasse ara::core::CoreErrorDomain (definiert im Header ara/core/core_error_domain.h) dient dem synchronen Auslösen einer C++-Exception auf Basis eines übergebenen Fehlercodes [SWS_CORE_05244]. Als Parameter nimmt die Funktion eine Referenz auf eine konstante Instanz von ErrorCode entgegen (const ErrorCode &errorCode) [SWS_CORE_05244]. Die Methode besitzt keinen Rückgabewert, sondern wirft unmittelbar eine Ausnahme vom Typ CoreException, welche das übergebene ErrorCode-Objekt vollständig kapselt [SWS_CORE_05244].

Hinsichtlich Ausführungskontext, Nebenläufigkeit und Compiler-Bedingungen gelten folgende Vorgaben:

  • Thread-Sicherheit: Die Funktion ist als threadsicher (thread-safe) spezifiziert und kann somit sicher aus nebenläufigen Kontexten aufgerufen werden [SWS_CORE_05244].
  • Exception-Sicherheit: Das Verhalten ist formal als nicht ausnahmesicher (not exception safe) klassifiziert, da die Funktion mit noexcept(false) deklariert ist und bestimmungsgemäß eine Exception wirft [SWS_CORE_05244].
  • Compiler-Einschränkung: Wenn C++-Exceptions in der Compiler-Toolchain deaktiviert sind, darf die Methode gemäß [SWS_CORE_10304] nicht an der Überladungsauflösung teilnehmen [SWS_CORE_05244].

Im Architekturgefüge überschreibt (override) die Methode die rein virtuelle Basisfunktion ThrowAsException der abstrakten Klasse ara::core::ErrorDomain [SWS_CORE_00154]. In der typischen Anwendung wird die Funktion nicht direkt am Domain-Objekt aufgerufen, sondern über die Hilfsmethode ErrorCode::ThrowAsException() angestoßen, welche den Aufruf über this->Domain().ThrowAsException(*this) dynamisch an die zuständige Fehlerdomäne weiterleitet [SWS_CORE_00519].

Dieser Nutzungshinweis wurde von einer KI auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.

Implementer's Guide folgt (Komplexität 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#8be3b2f5
Content hash
8be3b2f5
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

Dokumentation der Typaliase

type alias 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#634f1492
Content hash
634f1492
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

type alias 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#9c108ed5
Content hash
9c108ed5
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