classe ara::diag::DiagnosticSovdArrayContentElementDataView

usar

A função-membro Clear da classe ara::diag::DiagnosticSovdArrayContentElementDataView esvazia todo o conteúdo de um elemento de array SOVD ([SWS_DM_02233]). A chamada é disponibilizada por meio do cabeçalho #include "ara/diag/diagnostic_sovd_content_element_data.h". O método possui a assinatura auto Clear () noexcept -> void;. Ele opera de forma síncrona, não recebe parâmetros e não fornece valor de retorno ([SWS_DM_02233]).

Tratamento de erros e condições de contorno

De acordo com a especificação, a função é definida como segura para exceções (exception safe) e provida com o especificador noexcept ([SWS_DM_02233]). Ela não retorna códigos de erro nem um ara::core::Result. Como requisito vinculativo, o DiagnosticSovdContentElementData referenciado deve ser do tipo ArrayContentElementData ([SWS_DM_02233]). Como nenhum erro é sinalizado, o cumprimento deste tipo já deve estar assegurado em tempo de construção pela classe de visualização. Pergunta Q-cdb2385e081c3456 (aberta)

simultaneidade

A especificação classifica o método expressamente como seguro para threads (thread-safe) ([SWS_DM_02233]). Chamadas de Clear podem, portanto, ocorrer concorrentemente a partir de múltiplas threads sem sincronização externa.

Interação no subsistema de diagnóstico

Dentro das estruturas de dados SOVD, a operação está intimamente relacionada a outros métodos de exclusão:

• DiagnosticSovdContentElementData::Clear ([SWS_DM_02338]) constitui o equivalente genérico no nível de elemento, mas retorna um ara::core::Result<void> e falha caso o objeto não represente um array.
• DiagnosticSovdRecordContentElementDataView::Clear ([SWS_DM_02276]) assume a limpeza análoga para estruturas de dados do tipo RecordContentElementData ou ContentData.
• No contexto clássico de memória de erros, por outro lado, ara::diag::DTCInformation::Clear ([SWS_DM_00671]) serve à limpeza assíncrona de DTCs UDS via ara::core::Future.

usar

O método Erase da classe ara::diag::DiagnosticSovdArrayContentElementDataView serve para a remoção de um elemento de dados de conteúdo SOVD de diagnóstico ([SWS_DM_02247], SWS Diagnostics §8.60.5.1.1.8 «Erase»). Como parâmetro, a função recebe um iterador do tipo DiagnosticSovdArrayContentElementDataIterator, o qual aponta para o elemento a ser excluído. A chamada ocorre como uma operação síncrona; supõe-se que isso decorra do retorno direto de ara::core::Result<void> sem padrão de future assíncrono. Pergunta Q-28de22574e525c78 (aberta)

Tratamento de erros e condições de contorno

A função é declarada com noexcept e possui as propriedades exception safe bem como thread-safe ([SWS_DM_02247]). Se a exclusão falhar, o método fornecerá um erro por meio do ara::core::Result retornado. Este é o caso se o DiagnosticSovdContentElementData de nível superior não for do tipo exigido ArrayContentElementData ou se o elemento não tiver podido ser removido por outros motivos ([SWS_DM_02247]).

Interação

Dentro da interface SOVD, esta operação corresponde ao método de exclusão Erase do contêiner de dados subjacente DiagnosticSovdContentElementData para elementos de array ([SWS_DM_02352]). Para estruturas de registro (record), existem contrapartes análogas com DiagnosticSovdRecordContentElementDataView::Erase, bem como com o respectivo método de contêiner ([SWS_DM_02294], [SWS_DM_02374]).

A função-membro síncrona PushBack serve para anexar um elemento inteiro com sinal do tipo std::int64_t a uma estrutura de array de elementos de conteúdo SOVD de diagnóstico ([SWS_DM_02241], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.14 «PushBack»). Ela é declarada no arquivo de cabeçalho ara/diag/diagnostic_sovd_content_element_data.h e definida como noexcept ([SWS_DM_02241]).

Para uma chamada bem-sucedida, aplicam-se os seguintes pré-requisitos e requisitos de interface:

• Contexto de chamada e pré-condições: o objeto de destino da classe ara::diag::DiagnosticSovdArrayContentElementDataView deve representar um ArrayContentElementData, e o tipo primitivo a ser adicionado deve corresponder ao tipo de elemento definido no construtor ([SWS_DM_02241]).
• Valor de retorno e tratamento de erros: a função retorna um ara::core::Result<void>. Se a verificação falhar porque o elemento subjacente não é do tipo ArrayContentElementData, o resultado conterá um erro ([SWS_DM_02241]). Interpretação: uma discrepância em relação ao tipo de dados especificado no construtor provavelmente será reportada de forma análoga como erro no objeto de resultado. Pergunta Q-d4715ecbd0f12d26 (aberta)
• Concorrência: a função é especificada como thread-safe e exception-safe ([SWS_DM_02241]).

O método faz parte de uma família de sobrecargas tipadas dentro de DiagnosticSovdArrayContentElementDataView para inteiros sem sinal ([SWS_DM_02242]), números de ponto flutuante ([SWS_DM_02243]), valores booleanos ([SWS_DM_02244]), cadeias de caracteres ([SWS_DM_02245]) e elementos de dados completos ([SWS_DM_02246]). Métodos correspondentes também existem na própria classe de dados DiagnosticSovdContentElementData ([SWS_DM_02346]).

usar

A função de API síncrona PushBack da classe ara::diag::DiagnosticSovdArrayContentElementDataView anexa um valor inteiro sem sinal de 64 bits (std::uint64_t) como elemento de dados primitivo ao final de um elemento de array SOVD existente [SWS_DM_02242]. A integração é feita por meio do arquivo de cabeçalho ara/diag/diagnostic_sovd_content_element_data.h SWS Diagnostics §8.60.5.1.1.15 «PushBack». O pré-requisito para a chamada bem-sucedida é que o elemento atual represente um ArrayContentElementData e que o valor a ser adicionado corresponda ao tipo de elemento definido no construtor [SWS_DM_02242].

Tratamento de erros e simultaneidade

A função sinaliza seu status de execução por meio de ara::core::Result<void> [SWS_DM_02242]. Se o objeto de destino não for do tipo ArrayContentElementData, a função retorna um erro no resultado [SWS_DM_02242]. Como nenhum código de erro específico é mencionado (interpretação: estados de erro são sinalizados genericamente pelo Result), o chamador deve avaliar o objeto Result. Pergunta Q-95f2dd96e2681368 (aberta) O método é declarado como noexcept, garante segurança contra exceções (exception safety) e é explicitamente especificado como thread-safe [SWS_DM_02242].

Interação

A operação pertence a uma família de sobrecargas específicas de tipo dentro de DiagnosticSovdArrayContentElementDataView que processam de forma análoga inteiros com sinal via std::int64_t [SWS_DM_02241], números de ponto flutuante via double [SWS_DM_02243], valores booleanos via bool [SWS_DM_02244], cadeias de caracteres via ara::core::StringView [SWS_DM_02245] ou elementos estruturados do tipo DiagnosticSovdContentElementData [SWS_DM_02246]. Uma implementação equivalente para std::uint64_t também é fornecida por DiagnosticSovdContentElementData [SWS_DM_02347].

usar

O método síncrono PushBack é disponibilizado por meio do arquivo de cabeçalho #include "ara/diag/diagnostic_sovd_content_element_data.h" no escopo da classe ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02243], AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.13 «PushBack»). Ele anexa um valor primitivo de ponto flutuante do tipo double como elemento de conteúdo a um array existente ([SWS_DM_02243]). O único parâmetro de passagem é o dado a ser anexado content_element.

Tratamento de erros e condições de contorno

A função retorna um ara::core::Result<void> ([SWS_DM_02243]). Uma execução bem-sucedida requer que o elemento atual seja do tipo ArrayContentElementData e que o elemento a ser adicionado corresponda ao tipo definido no construtor de ArrayContentElementData ([SWS_DM_02243]). Caso o destino não seja do tipo ArrayContentElementData, a operação falhará e retornará um erro no Result ([SWS_DM_02243]).

simultaneidade

A função é declarada como noexcept, assegura segurança contra exceções (exception safe) e é, de acordo com a especificação, thread-safe ([SWS_DM_02243]). Múltiplas threads podem, portanto, chamar a função de forma concorrente sem sincronização externa.

Interação

Dentro de DiagnosticSovdArrayContentElementDataView existem sobrecargas de mesmo tipo para outros tipos de dados primitivos, incluindo std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), bool ([SWS_DM_02244]), ara::core::StringView ([SWS_DM_02245]), bem como para objetos DiagnosticSovdContentElementData completos ([SWS_DM_02246]). Métodos análogos também estão disponíveis em DiagnosticSovdContentElementData (por exemplo, [SWS_DM_02348]).

A função de membro PushBack serve para anexar um DiagnosticSovdContentElementData com o tipo de dados primitivo bool a um elemento de array existente ([SWS_DM_02244]). A interface é definida no cabeçalho ara/diag/diagnostic_sovd_content_element_data.h dentro da classe ara::diag::DiagnosticSovdArrayContentElementDataView (AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.12 «PushBack»). Como parâmetro de entrada, a função síncrona recebe o valor booleano content_element ([SWS_DM_02244]).

O pré-requisito para a chamada é que o elemento atual seja do tipo ArrayContentElementData e que o valor a ser anexado coincida com o tipo declarado no construtor da estrutura de dados ([SWS_DM_02244]). Se o elemento de destino não for do tipo ArrayContentElementData, a operação falhará e retornará um ara::core::Result<void> com um erro correspondente; em caso de sucesso, o resultado conterá um void vazio ([SWS_DM_02244]).

Em relação à segurança de execução, o método é declarado como noexcept e especificado como thread-safe (thread-safe) e seguro contra exceções (exception safe) ([SWS_DM_02244]).

O método faz parte de uma família de sobrecargas tipadas de PushBack dentro de DiagnosticSovdArrayContentElementDataView. Além de valores booleanos, funções irmãs abrangem a inserção de tipos inteiros como std::int64_t ([SWS_DM_02241]) e std::uint64_t ([SWS_DM_02242]), valores de ponto flutuante double ([SWS_DM_02243]), cadeias de caracteres ara::core::StringView ([SWS_DM_02245]), bem como elementos de dados complexos ([SWS_DM_02246]). Operações correspondentes também estão disponíveis no nível de DiagnosticSovdContentElementData, incluindo a variante booleana [SWS_DM_02349].

usar

A função-membro síncrona PushBack da classe ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02245], definida em SWS Diagnostics §8.60.5.1.1.11 «PushBack») anexa um novo elemento com o tipo primitivo cadeia de caracteres a um array de diagnóstico SOVD. Para tal, deve ser incluído o cabeçalho ara/diag/diagnostic_sovd_content_element_data.h. A função recebe o elemento a adicionar através do parâmetro content_element do tipo ara::core::StringView.

Tratamento de erros

O tipo de retorno serve como ara::core::Result<void>. É retornado um erro no objeto de resultado caso o objeto atual não seja do tipo ArrayContentElementData ou o tipo do elemento fornecido não coincida com o tipo de elemento definido no construtor de ArrayContentElementData ([SWS_DM_02245]).

Simultaneidade e restrições

A função está declarada com o especificador noexcept. Oferece segurança garantida contra exceções (exception safe) e está especificada como totalmente segura para threads (thread-safe) ([SWS_DM_02245]).

Interação

A operação faz parte de uma família de métodos sobrecarregados. Dentro de DiagnosticSovdArrayContentElementDataView existem outras sobrecargas para tipos escalares como std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), double ([SWS_DM_02243]) e bool ([SWS_DM_02244]), bem como para elementos completos do tipo DiagnosticSovdContentElementData ([SWS_DM_02246]). Além disso, a classe ara::diag::DiagnosticSovdContentElementData também disponibiliza uma interface PushBack correspondente para cadeias de caracteres ([SWS_DM_02350]).

usar

A função-membro síncrona PushBack da classe ara::diag::DiagnosticSovdArrayContentElementDataView (SWS Diagnostics §8.60.5.1.1.10 «PushBack») anexa um elemento do tipo DiagnosticSovdContentElementData a uma visão de dados de array existente ([SWS_DM_02246]). Como parâmetro de passagem, ela recebe o objeto a ser adicionado content_element por valor e não possui valor de retorno (void). A declaração é fornecida pelo arquivo de cabeçalho ara/diag/diagnostic_sovd_content_element_data.h.

Concorrência e pré-condições

A especificação define a função como segura contra exceções (exception safe), thread-safe (thread-safe) e anotada com noexcept ([SWS_DM_02246]). Como pré-condição obrigatória, a operação exige que o elemento atual seja do tipo ArrayContentElementData e que o elemento a ser anexado corresponda exatamente ao tipo definido no construtor de ArrayContentElementData ([SWS_DM_02246]).

Tratamento de erros e interação

Diferentemente das sobrecargas para tipos primitivos como std::int64_t ([SWS_DM_02241]), std::uint64_t ([SWS_DM_02242]), double ([SWS_DM_02243]), bool ([SWS_DM_02244]) ou ara::core::StringView ([SWS_DM_02245]), que retornam um ara::core::Result<void> para transmissão de erros, este método retorna void. Portanto, deve ser responsabilidade do chamador verificar previamente a compatibilidade de tipos, visto que erros de tempo de execução nesta interface não são sinalizados por meio de um tipo Result. Pergunta Q-00739dff7d34e242 (aberta) Um método equivalente para anexar elementos de dados também está definido em DiagnosticSovdContentElementData ([SWS_DM_02351]).

O método síncrono Reserve da classe ara::diag::DiagnosticSovdArrayContentElementDataView serve para a pré-alocação de capacidade de memória para elementos de dados de array ([SWS_DM_02240], SWS Diagnostics §8.60.5.1.1.16 «Reserve»). Ele é disponibilizado por meio do cabeçalho #include "ara/diag/diagnostic_sovd_content_element_data.h" e recebe o parâmetro capacity do tipo std::size_t, que define a capacidade a ser disponibilizada da DiagnosticSovdArrayContentElementData subjacente ([SWS_DM_02240]). Não é retornado nenhum valor de retorno ([SWS_DM_02240]).

Em relação ao tratamento de erros, a função é declarada como segura para exceções (exception safe), bem como noexcept ([SWS_DM_02240]). Ela não utiliza códigos de erro via ara::core::Result nem exceções C++. Interpretação: em caso de escassez de memória, a alocação presumivelmente falha internamente ou leva à terminação do programa, uma vez que nenhum canal de erro está à disposição do chamador. Pergunta Q-348805197c004eea (aberta)

Para a concorrência, a operação é explicitamente especificada como segura para threads (thread-safe) ([SWS_DM_02240]). Chamadas podem, assim, ocorrer a partir de threads paralelas sem bloqueio externo.

No sistema global, a interface complementa funções de reserva correlatas: enquanto DiagnosticSovdRecordContentElementDataView::Reserve é responsável de forma análoga por estruturas de dados do tipo record ([SWS_DM_02283], SWS Diagnostics §8.60.11.1.1.20 «Reserve»), a função genérica da classe base DiagnosticSovdContentElementData::Reserve fornece um ara::core::Result<void> para reportar um erro em caso de tipo de elemento incorreto ([SWS_DM_02345], SWS Diagnostics §8.60.6.1.2.55 «Reserve»). Em contraste com a reserva de memória não segura para threads DiagnosticServiceDynamicAccessList::Reserve ([SWS_DM_01163], SWS Diagnostics §8.13.1.1.3.3 «Reserve»), este método de visualização opera direta e concorrentemente sobre elementos de array SOVD.