class ara::exec::ExecErrorDomain

The default constructor ExecErrorDomain() initializes a new instance of the error domain ara::exec::ExecErrorDomain according to [SWS_EM_02286]. The call is synchronous, takes no parameters, and has no return value. The declaration is included via header ara/exec/exec_error_domain.h.

Regarding robustness and concurrency, the constructor is declared as noexcept, is considered exception safe (exception safe), and is specified as unconditionally thread-safe (thread-safe) [SWS_EM_02286]. Error handling during object creation is not required because the operation executes without error and raises no error codes or exceptions.

In the overall system, the created object serves to represent and describe module-specific errors of Execution Management. Via the instance, the domain name can be queried [SWS_EM_02287], textual messages for error codes can be determined [SWS_EM_02288], or errors can be thrown as a C++ exception [SWS_EM_02289]. Explicit instantiation via this constructor is likely rarely necessary in application modules, as a global reference to the instance is already provided via the free function GetExecErrorDomain() [SWS_EM_02290]. Question Q-df8efc87e6547216 (open)

The method Message is a virtual member function of class ara::exec::ExecErrorDomain within the Execution Management functional cluster [SWS_EM_02288]. It is included via the header file ara/exec/exec_error_domain.h and overrides the corresponding interface for determining textual error messages [SWS_EM_02288].

The usage is as follows:

• Call and semantics: The call is synchronous and is designed as a read-only operation (const) [SWS_EM_02288].
• Parameters: Passed as input parameter is errorCode of type CodeType, which represents the numeric identifier of the error [SWS_EM_02288].
• Return value: The function returns a pointer of type const char * to the error message associated with the error code [SWS_EM_02288]. Interpretation: It can be assumed that this pointer refers to a static string, so that no memory deallocation is required for the caller. Question Q-3e254e008a07294e (open)

Regarding error handling, the function is declared as noexcept and specified as exception safe [SWS_EM_02288]. The function itself does not throw C++ exceptions. Dedicated error codes or reporting channels for faulty calls are not provided in the specification [SWS_EM_02288].

Regarding concurrency, the method is classified as thread-safe [SWS_EM_02288]. Since it does not modify the state of the error domain, it can safely be called in parallel by multiple threads without external synchronization mechanisms [SWS_EM_02288].

use

The member function Name of class ara::exec::ExecErrorDomain synchronously returns a pointer to a character-based constant (const char *) identifying the error domain [SWS_EM_02287]. The return conforms to the definition for ara::exec::ExecErrorDomain from [SWS_CORE_90023]. The method is included via header ara/exec/exec_error_domain.h, expects no input parameters, and operates as a const member function on instances of the error domain [SWS_EM_02287].

Error Handling and Concurrency

The interface is declared as noexcept and is thus classified as completely exception safe (exception safe) [SWS_EM_02287]. Neither error codes are returned nor exceptions thrown. Regarding concurrent access, the function is specified as thread-safe (thread-safe) [SWS_EM_02287]. Calls can consequently be executed in parallel from different threads without additional synchronization measures.

Interaction

By being declared as override, the function implements the general interface for querying the domain name within the scope of [SWS_CORE_90023]. The returned string presumably serves to uniquely identify the error domain in a human-readable form in log or diagnostic outputs [SWS_EM_02287]. Question Q-ae1f9de8510d7ff9 (open)

The method ThrowAsException of the error domain ara::exec::ExecErrorDomain serves to synchronously throw a C++ exception based on an occurred error code [SWS_EM_02289]. It accepts a reference to errorCode (type const ara::core::ErrorCode &) as an input parameter, instantiates an exception object of type ExecException from it, and throws it immediately as a C++ exception [SWS_EM_02289]. The function returns no value.

With regard to error and runtime behavior, the following aspects must be observed:

• Exception safety: Since the intended behavior of the function consists in throwing an exception, it is annotated with noexcept(false) and formally classified as not exception safe (not exception safe) [SWS_EM_02289]. Callers must therefore be prepared to catch or handle ExecException.
• Concurrency: The specification designates the member function as thread-safe (thread-safe) [SWS_EM_02289]. It can therefore safely be called from concurrent threads.
• Toolchain restrictions: According to [SWS_CORE_10304], ThrowAsException does not participate in overload resolution if C++ exceptions are disabled in the compiler toolchain [SWS_EM_02289]. In environments without exception support, this call is consequently not available.