classe ara::diag::DiagnosticSovdArrayContentElementDataIterator

A classe ara::diag::DiagnosticSovdArrayContentElementDataIterator serve para a iteração passo a passo sobre elementos de array SOVD em conteúdos de diagnóstico ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 «Class: DiagnosticSovdArrayContentElementDataIterator»). Ela disponibiliza operadores para comparação, avanço via pré-incremento e desreferenciação a fim de fornecer referências ou ponteiros para DiagnosticSovdContentElementData ([SWS_DM_02216], [SWS_DM_02220]). Todas as funções são thread-safe e especificadas como noexcept, razão pela qual a validade da faixa de destino deve ser assegurada pela aplicação antes da desreferenciação.

mais ›

Contexto

A classe ara::diag::DiagnosticSovdArrayContentElementDataIterator disponibiliza um iterador específico para elementos de array no âmbito da comunicação de diagnóstico baseada em SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 «Class: DiagnosticSovdArrayContentElementDataIterator»). A sua responsabilidade primária reside na disponibilização de interfaces de iteração padronizadas para navegar sequencialmente pelos elementos de um array de dados. Como parceiros de interação atuam aplicações de diagnóstico chamadoras, bem como os elementos de destino referenciados do tipo DiagnosticSovdContentElementData ([SWS_DM_02216], [SWS_DM_02217]). O iterador é declarado no header ara/diag/diagnostic_sovd_content_element_data.h (AUTOSAR_AP_SWS_Diagnostics §8.60.4.1 «Public Member Functions»).

Ciclo de vida

A especificação não define construtores públicos próprios para ara::diag::DiagnosticSovdArrayContentElementDataIterator; consequentemente, as instâncias são criadas e disponibilizadas pelas respetivas estruturas de contentor SOVD através dos seus métodos de iterador (interpretação). Pergunta Q-e1fbf51ab4acc197 (aberta) O próprio iterador não detém a propriedade dos dados úteis subjacentes, mantendo apenas referências para os respetivos elementos na memória. A validade de uma instância de iterador deverá, portanto, estar estritamente vinculada ao tempo de vida e à validade da estrutura de dados de nível superior (interpretação). Pergunta Q-c01219664b4adc56 (aberta)

No que diz respeito ao ciclo de vida e à simultaneidade, todas as funções-membro estão especificadas como seguras contra exceções (exception safe) e seguras para threads (thread-safe) ([SWS_DM_02216], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Isto permite operações simultâneas de leitura e avanço através de múltiplas threads, desde que a estrutura de dados subjacente não seja alterada de forma destrutiva e concorrente.

Caminho de utilização

O fluxo regular segue o padrão típico de iteradores forward em C++. As aplicações comparam a posição atual do iterador com um iterador final através de operator!= ([SWS_DM_02219]) ou operator== ([SWS_DM_02218], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.5 «operator==»). Se o final ainda não tiver sido alcançado, o acesso de leitura ao elemento atual ocorre através da desreferenciação operator* ([SWS_DM_02216]) para retornar uma referência para DiagnosticSovdContentElementData ou através do operador seta operator-> ([SWS_DM_02217], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.4 «operator->») para retornar um ponteiro correspondente. Em seguida, a aplicação avança a posição para o próximo elemento do array utilizando o operador de pré-incremento operator++ ([SWS_DM_02220], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.3 «operator++»).

Diagrama de sequência: sequência de chamadas durante um ciclo de iteração sobre elementos de array SOVD. Fontes: [SWS_DM_02216], [SWS_DM_02219], [SWS_DM_02220].

Cenários de erro

Todos os métodos do iterador contêm a especificação noexcept e, por definição, não lançam exceções ([SWS_DM_02216], [SWS_DM_02217], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Códigos de erro como ara::core::ErrorCode não estão previstos para estas interfaces. A correção é da responsabilidade das condições de chamada da aplicação: uma desreferenciação através de operator* ou operator-> requer obrigatoriamente, como pré-condição, que o iterador aponte para um elemento de array válido e não para a posição final; um acesso a iteradores inválidos deverá conduzir a comportamento indefinido (interpretação). Pergunta Q-63d87e38f9886f6b (aberta)