classe ara::exec::ExecErrorDomain

O construtor padrão ExecErrorDomain() inicializa uma nova instância do domínio de erro ara::exec::ExecErrorDomain conforme [SWS_EM_02286]. A chamada ocorre de forma síncrona, não recebe parâmetros e não possui valor de retorno. A declaração é incluída por meio do cabeçalho ara/exec/exec_error_domain.h.

Em termos de robustez e concorrência, o construtor é declarado como noexcept, é considerado seguro contra exceções (exception safe) e está especificado como irrestritamente thread-safe (thread-safe) [SWS_EM_02286]. Não é necessário um tratamento de erros na criação do objeto, pois a operação é executada sem falhas e não lança códigos de erro nem exceções.

No sistema global, o objeto criado serve para a representação e descrição de erros específicos de módulo do Execution Management. Por meio da instância, é possível consultar o nome do domínio [SWS_EM_02287], determinar mensagens textuais para códigos de erro [SWS_EM_02288] ou lançar erros como exceção C++ [SWS_EM_02289]. Uma instanciação explícita por meio deste construtor raramente deve ser necessária em módulos de aplicação, pois uma referência global para a instância já é disponibilizada por meio da função livre GetExecErrorDomain() [SWS_EM_02290]. Pergunta Q-df8efc87e6547216 (aberta)

O método Message é uma função-membro virtual da classe ara::exec::ExecErrorDomain dentro do cluster funcional Execution Management [SWS_EM_02288]. Ele é incluído por meio do arquivo de cabeçalho ara/exec/exec_error_domain.h e sobrescreve a respectiva interface para a determinação de mensagens de erro textuais [SWS_EM_02288].

O uso se dá da seguinte forma:

• Chamada e semântica: a chamada ocorre de forma síncrona e é concebida como uma operação de leitura (const) [SWS_EM_02288].
• Parâmetros: como parâmetro de entrada é passado errorCode do tipo CodeType, que representa o identificador numérico do erro [SWS_EM_02288].
• Valor de retorno: a função retorna um ponteiro do tipo const char * para a mensagem de erro associada ao código de erro [SWS_EM_02288]. Interpretação: deve-se assumir que este ponteiro aponta para uma string estática, de modo que não é necessária nenhuma liberação de memória para o chamador. Pergunta Q-3e254e008a07294e (aberta)

No que diz respeito ao tratamento de erros, a função é declarada como noexcept e especificada como exception safe [SWS_EM_02288]. A própria função não lança exceções C++. Códigos de erro próprios ou canais de retorno para chamadas errôneas não estão previstos na especificação [SWS_EM_02288].

Em relação à concorrência, o método é classificado como thread-safe [SWS_EM_02288]. Uma vez que não altera o estado do domínio de erro, ele pode ser chamado com segurança em paralelo por múltiplas threads sem mecanismos externos de sincronização [SWS_EM_02288].

usar

A função-membro Name da classe ara::exec::ExecErrorDomain fornece de forma síncrona um ponteiro para uma constante baseada em caracteres (const char *), que designa o domínio de erro [SWS_EM_02287]. O retorno orienta-se pela definição para ara::exec::ExecErrorDomain de [SWS_CORE_90023]. O método é incluído por meio do cabeçalho ara/exec/exec_error_domain.h, não espera parâmetros de entrada e opera como função-membro constante em instâncias do domínio de erro [SWS_EM_02287].

Tratamento de erros e simultaneidade

A interface é declarada como noexcept e, portanto, classificada como totalmente segura para exceções (exception safe) [SWS_EM_02287]. Não são retornados códigos de erro nem lançadas exceções. No que se refere ao acesso concorrente, a função é especificada como segura para threads (thread-safe) [SWS_EM_02287]. Consequentemente, chamadas podem ser executadas em paralelo a partir de diferentes threads sem medidas adicionais de sincronização.

Interação

Pela declaração como override, a função implementa a interface geral para consulta do nome do domínio no âmbito de [SWS_CORE_90023]. A string retornada serve presumivelmente para identificar o domínio de erro de forma unívoca e legível em saídas de log ou de diagnóstico [SWS_EM_02287]. Pergunta Q-ae1f9de8510d7ff9 (aberta)

O método ThrowAsException do domínio de erros ara::exec::ExecErrorDomain serve para o acionamento síncrono de uma exceção C++ com base em um código de erro [SWS_EM_02289] ocorrido. Ele recebe como parâmetro de entrada uma referência a errorCode (tipo const ara::core::ErrorCode &), instancia a partir dela um objeto de exceção do tipo ExecException e lança-o imediatamente como exceção C++ [SWS_EM_02289]. A função não retorna nenhum valor de retorno.

Em relação ao comportamento de erros e em tempo de execução, devem ser observados os seguintes aspectos:

• Segurança contra exceções: Como o comportamento pretendido da função consiste no acionamento de uma exceção, ela é anotada com noexcept(false) e formalmente classificada como não segura contra exceções (not exception safe) [SWS_EM_02289]. Os chamadores devem, portanto, estar preparados para capturar ou tratar ExecException.
• Concorrência: A especificação classifica a função-membro como thread-safe (thread-safe) [SWS_EM_02289]. Ela pode, assim, ser chamada com segurança a partir de threads concorrentes.
• Restrições da toolchain: De acordo com [SWS_CORE_10304], ThrowAsException não participa da resolução de sobrecarga se as exceções C++ estiverem desativadas na toolchain do compilador [SWS_EM_02289]. Em ambientes sem suporte a exceções, essa chamada não está, portanto, disponível.