classe ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

A classe ara::diag::DiagnosticSovdRecordContentElementDataConstIterator funciona, de acordo com [SWS_DM_02264], como um iterador forward constante para a travessia protegida contra escrita de elementos de conteúdo de registo SOVD. Oferece operadores para verificações de igualdade, avanço, bem como a desreferenciação para DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]). Uma vez que todos os operadores são implementados como seguros contra exceções e thread-safe de acordo com noexcept, é da responsabilidade do chamador não desreferenciar iteradores inválidos.

mais ›

Contexto

A classe ara::diag::DiagnosticSovdRecordContentElementDataConstIterator é definida por [SWS_DM_02264] em AUTOSAR_AP_SWS_Diagnostics §8.60.8. Serve como iterador forward ou de entrada constante para elementos do tipo DiagnosticSovdRecordContentElementData, conforme descrito em AUTOSAR_AP_SWS_Diagnostics §8.60.8. Como parceiros de interação atuam aplicações de diagnóstico do módulo diag, que percorrem coleções de elementos de dados SOVD («Service-Oriented Vehicle Diagnostics») de forma protegida contra escrita, bem como os elementos referenciados do tipo DiagnosticSovdContentElementDataWithKey, aos quais o iterador concede acesso durante a desreferenciação ([SWS_DM_02265], [SWS_DM_02266]).

Ciclo de vida

O ciclo de vida de um iterador começa tipicamente com a obtenção de uma instância de iterador através da interface de uma estrutura de dados subjacente para elementos de registo SOVD (interpretação: os contentores possuem presumivelmente métodos como cbegin() e cend(), que fornecem instâncias de iterador válidas). Pergunta Q-9c5e4d32ae82e7cf (aberta) Como se trata de um mero wrapper de valor ou ponteiro sem gestão dinâmica de recursos, o iterador não possui nenhum mecanismo de destruição explícito e pode ser copiado ou movido. A especificação assegura para todas as operações do iterador segurança contra exceções (exception safe), bem como total segurança de threads (thread-safe) ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). No que diz respeito à simultaneidade, isto significa que os acessos de leitura paralelos ao mesmo iterador ou a instâncias mutuamente independentes podem ser executados sem medidas de sincronização adicionais.

Caminho de utilização

O caminho de utilização típico inclui a travessia iterativa de um conjunto de dados de elementos SOVD dentro de rotinas de processamento de diagnóstico. Um chamador verifica primeiro, através do operador de desigualdade operator!= ([SWS_DM_02268]) ou do operador de igualdade operator== ([SWS_DM_02267]), se o fim da sequência foi alcançado. Enquanto o iterador for válido, a aplicação acede em modo de leitura ao elemento referenciado: o operador de desreferenciação operator* fornece uma referência constante para DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]), enquanto o operador de seta operator-> retorna um ponteiro para o objeto constante ([SWS_DM_02266]). Em seguida, o operador de pré-incremento operator++ avança o iterador uma posição e retorna uma referência para o iterador incrementado ([SWS_DM_02269]).

Diagrama de sequência: sequência típica da travessia sequencial de elementos de conteúdo de registo SOVD através do const-iterator. Fontes: [SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]

Cenários de erro

Todas as funções-membro de ara::diag::DiagnosticSovdRecordContentElementDataConstIterator estão declaradas com o especificador noexcept ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Nem operator* nem operator-> ou os operadores de comparação lançam exceções C++ ou retornam estruturas de erro ara::core::Result. A pré-condição para uma chamada sem erros de operator*, operator-> e operator++ é a validade do iterador: a desreferenciação ou o avanço de um iterador de fim (past-the-end) deverá conduzir a comportamento indefinido (interpretação: a definição da interface não contém verificações em tempo de execução para desreferenciações inválidas). Pergunta Q-e26c9aa50597bf18 (aberta) Os utilizadores devem, por isso, assegurar que é sempre efetuada uma comparação de paragem com o iterador de fim antes do acesso.