classe ara::diag::DiagnosticSovdRecordContentElementDataIterator

A classe ara::diag::DiagnosticSovdRecordContentElementDataIterator serve como iterador para percorrer sequencialmente elementos de dados de diagnóstico de uma gravação SOVD ([SWS_DM_02258]). Através dos operadores de desreferenciação, as aplicações obtêm acesso a elementos do tipo DiagnosticSovdContentElementDataWithKey, enquanto o avanço é efetuado através do operador de incremento. Como condição limite central, todas as funções estão especificadas como noexcept e seguras para threads ([SWS_DM_02263]). Interpretação: a aplicação chamadora deve verificar de forma autónoma, antes de cada acesso, se o fim da sequência foi atingido, de modo a evitar comportamento indefinido. Pergunta Q-819b2e03155473ad (aberta)

mais ›

Contexto

A classe ara::diag::DiagnosticSovdRecordContentElementDataIterator está especificada na AUTOSAR Adaptive Platform como iterador para elementos de dados de gravações SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_02258], AUTOSAR_AP_SWS_Diagnostics §8.60.10 «Class: DiagnosticSovdRecordContentElementDataIterator»). Dentro do subsistema de Diagnostics, serve como interface de acesso padronizada para percorrer elemento a elemento dados de diagnóstico estruturados de uma gravação SOVD.

Entre os parceiros de interação primários encontram-se a aplicação de diagnóstico solicitante, que processa dados de gravação, bem como a estrutura de dados subjacente do módulo de diagnóstico. O iterador faz a mediação do acesso a elementos de dados individuais do tipo DiagnosticSovdContentElementDataWithKey, disponibilizando opcionalmente referências ou ponteiros para estes elementos de dados através dos seus operadores de desreferenciação ([SWS_DM_02259], [SWS_DM_02260]).

Ciclo de vida

As instâncias do iterador são tipicamente criadas durante operações de consulta sobre conteúdos SOVD. A especificação não define nenhum construtor público autónomo no âmbito da API para o iterador; as instâncias deverão, por conseguinte, ser disponibilizadas principalmente por contentores de nível superior ou funções de consulta e copiadas como valores. Pergunta Q-e79bbdff728ef3f2 (aberta) O iterador aponta para dados úteis existentes sem assumir a respetiva posse.

O ciclo de vida dentro de um processo de travessia é controlado por passos de avanço e comparações de posição. Através do operador de pré-incremento operator++, o iterador é avançado para o elemento de dados seguinte ([SWS_DM_02263]). A validade e o alcance do fim da sequência são determinados através dos operadores de igualdade e desigualdade operator== ([SWS_DM_02261]) e operator!= ([SWS_DM_02262]) face a um iterador sentinela ou de fim.

No que diz respeito à simultaneidade, todas as funções-membro da classe estão explicitamente especificadas como seguras para threads ([SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02261], [SWS_DM_02262], [SWS_DM_02263]). Isto permite acessos de leitura paralelos a instâncias de iterador separadas em ambientes multithreading.

Caminho de utilização

O fluxo típico na avaliação de conteúdos de registos SOVD segue o padrão clássico de iterador para a frente de C++:

• Verificação da condição de paragem: antes de cada acesso, a aplicação compara a posição atual com o iterador de fim através de operator!= ([SWS_DM_02262]).
• Acesso ao elemento: se o iterador estiver posicionado num elemento válido, a aplicação acede ao DiagnosticSovdContentElementDataWithKey por referência através de operator* ([SWS_DM_02259]) ou utiliza o operador de acesso a elementos operator-> ([SWS_DM_02260]) para endereçar diretamente métodos ou campos do elemento de dados.
• Avanço: através de operator++, o iterador é incrementado para a posição seguinte ([SWS_DM_02263]).

Diagrama de sequência: sequência típica da travessia de elementos de dados de registo SOVD. Fontes: [SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02262], [SWS_DM_02263].

Cenários de erro

Todas as operações especificadas do iterador estão declaradas como seguras contra exceções (exception safe) e como noexcept ([SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02261], [SWS_DM_02262], [SWS_DM_02263]). Isto significa que, em funcionamento normal, não são lançadas exceções e não surgem códigos de erro para avaliação.

Interpretação: como pré-condição essencial para as chamadas de operator*, operator-> e operator++, o iterador tem de referenciar uma posição válida e não pode corresponder ao iterador de fim. Pergunta (aberta) Um avanço ou desreferenciação de um iterador inválido deverá conduzir a comportamento indefinido no contexto padrão de C++. Por conseguinte, as aplicações têm de verificar rigorosamente o alcance do fim através de operator!= ou operator== ([SWS_DM_02261], [SWS_DM_02262]).