class ara::diag::DiagUdsNrcErrorDomain

The parameterless default constructor initializes an instance of error domain ara::diag::DiagUdsNrcErrorDomain synchronously and without parameters [SWS_DM_00532]. Due to the qualification as constexpr, instantiation can already take place at compile time AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 “Default Constructor”. In practical implementation, however, direct manual instantiation of domain class [SWS_DM_00529] by application code is likely rarely necessary, since the global reference is obtained by default via function GetDiagUdsNrcDomain() [SWS_DM_00536]. Question Q-22c33afd620b536e (open)

Regarding concurrency and exception safety, the constructor is specified as thread-safe and exception safe [SWS_DM_00532]. It is declared as noexcept and throws no exceptions itself. The domain manages error codes of enumeration type DiagUdsNrcErrc via the alias Errc [SWS_DM_00530], which are created by means of MakeErrorCode() [SWS_DM_00537]. In addition, the class provides methods such as Name() [SWS_DM_00533], Message() [SWS_DM_00534], and ThrowAsException() [SWS_DM_00535] within the scope of DiagUdsNrcException [SWS_DM_00531].

In interaction with Diagnostic Management, errors of this domain control negative response handling. If a ara::diag interface returns an error of DiagUdsNrcErrorDomain, the Diagnostic Server derives a negative UDS response (NRC) from it with the value of the error code in the valid range from 0x01 to 0xFE [SWS_DM_02059], [SWS_DM_02060]. If such an error occurs when retrieving an environmental element, the server evaluates the relevant condition as not fulfilled and issues a Log and Trace message [SWS_DM_00970].

use

The synchronous member function Message of class ara::diag::DiagUdsNrcErrorDomain converts a numerical error code into a readable string [SWS_DM_00534]. The error value errorCode of type ara::core::ErrorDomain::CodeType is passed as a parameter. The call returns a const pointer (const char *) to the corresponding message, where it is guaranteed that the return value is never nullptr [SWS_DM_00534].

Error Handling and Concurrency

The method is declared as noexcept and guarantees complete exception safety (exception safe) [SWS_DM_00534]. No exceptions are thrown. Even in the case of unknown or invalid values for errorCode, the implementation should presumably provide a static fallback message, as a null pointer is explicitly ruled out [SWS_DM_00534]. Question Q-e9724baf4aedc3ff (open) Furthermore, the function is specified as thread-safe (thread-safe) and can be called in parallel from multiple threads without external synchronization [SWS_DM_00534].

Interplay in Diagnostic Management

Within Diagnostic Management, Message implements the standardized override of error message resolution specifically for UDS Negative Response Codes (NRC) [SWS_DM_00534]. It corresponds to identical functions of other diagnostic error domains such as DiagErrorDomain [SWS_DM_00522], DiagOfferErrorDomain [SWS_DM_00994], DiagReportingErrorDomain [SWS_DM_01001], and DiagSovdErrorDomain [SWS_DM_01814].

use

The member function Name of class ara::diag::DiagUdsNrcErrorDomain returns the short name (ApApplicationErrorDomain.SN) of this specific diagnostic error domain [SWS_DM_00533]. The call is synchronous and is declared via header ara/diag/diag_uds_nrc_error_domain.h. The method takes no input parameters and returns a pointer of type const char * to a null-terminated string [SWS_DM_00533].

Error handling

The function is declared as noexcept and possesses the property exception safe [SWS_DM_00533]. It throws no exceptions and returns no error codes. A failure of the query is not provided for in the interface design, which is why no separate error messages exist.

Concurrency and Limitations

According to the specification, Name is classified as thread-safe [SWS_DM_00533]. It can be called reentrantly and without external synchronization mechanisms in parallel from multiple threads. The referenced string is likely to represent statically allocated data, so the pointer should remain valid and unchanged throughout the entire lifetime of the application. Question Q-d4a4d28af7a9c2df (open) No special sequencing conditions exist for the call.

Interaction

The operation implements the uniform name query for AUTOSAR Adaptive error domains in the diagnostic context. It structurally corresponds to the interfaces of the same name of related error domains such as ara::diag::DiagErrorDomain::Name [SWS_DM_00521], ara::diag::DiagOfferErrorDomain::Name [SWS_DM_00993], ara::diag::DiagReportingErrorDomain::Name [SWS_DM_01000], and ara::diag::DiagSovdErrorDomain::Name [SWS_DM_01813]. It primarily serves to legibly identify errors from the UDS NRC environment for diagnostic clients or logging components.

The member function ara::diag::DiagUdsNrcErrorDomain::ThrowAsException serves to synchronously convert an error from the UDS NRC error domain into a C++ exception [SWS_DM_00535]. The instance errorCode of type const ara::core::ErrorCode& is passed as a parameter. The function has no return value, but directly throws the exception type assigned to the error code AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 “ThrowAsException”.

Regarding error and runtime behavior, the method is declared with noexcept(false) and classified as not exception safe (not exception safe), since throwing the exception represents its primary semantics [SWS_DM_00535]. For the concurrent call context, the function is specified as thread-safe (thread-safe) [SWS_DM_00535].

The following conditions and design references apply to integration and system configuration:

• Compiler restriction: If C++ exceptions are disabled in the compiler toolchain, this function does not participate in overload resolution (overload resolution) according to [SWS_CORE_10304] [SWS_DM_00535].
• Interplay with error domains: The identical scheme for exception throwing is uniformly implemented in further diagnostic domains, such as in DiagErrorDomain [SWS_DM_00523], DiagOfferErrorDomain [SWS_DM_00995], DiagReportingErrorDomain [SWS_DM_01002], and DiagSovdErrorDomain [SWS_DM_01815].