classe ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

Conformément à [SWS_DM_02264], la classe ara::diag::DiagnosticSovdRecordContentElementDataConstIterator agit comme un itérateur avant constant pour la traversée en lecture seule d'éléments de contenu d'enregistrement SOVD. Il propose des opérateurs pour les vérifications d'égalité, l'avancement ainsi que le déréférencement vers DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]). Tous les opérateurs étant exécutés de manière sûre vis-à-vis des exceptions et thread-safe selon noexcept, la responsabilité incombe à l'appelant de ne déréférencer aucun itérateur invalide.

plus ›

Contexte

La classe ara::diag::DiagnosticSovdRecordContentElementDataConstIterator est définie par [SWS_DM_02264] dans AUTOSAR_AP_SWS_Diagnostics §8.60.8. Elle sert d'itérateur avant ou d'entrée constant pour des éléments du type DiagnosticSovdRecordContentElementData, comme décrit dans AUTOSAR_AP_SWS_Diagnostics §8.60.8. Les partenaires d'interaction sont alors les applications de diagnostic du module diag qui parcourent en lecture seule des collections d'éléments de données SOVD (« Service-Oriented Vehicle Diagnostics »), ainsi que les éléments référencés du type DiagnosticSovdContentElementDataWithKey auxquels l'itérateur accorde l'accès pendant le déréférencement ([SWS_DM_02265], [SWS_DM_02266]).

Cycle de vie

Le cycle de vie d'un itérateur commence typiquement par la récupération d'une instance d'itérateur via l'interface d'une structure de données sous-jacente pour les éléments d'enregistrement SOVD (interprétation : les conteneurs possèdent probablement des méthodes telles que cbegin() et cend() qui fournissent des exemplaires d'itérateurs valides). Question Q-9c5e4d32ae82e7cf (ouverte) Comme il s'agit d'un pur wrapper de valeur ou de pointeur sans gestion dynamique des ressources, l'itérateur ne possède aucun mécanisme explicite de destruction et peut être copié ou déplacé. La spécification garantit pour toutes les opérations de l'itérateur la sécurité vis-à-vis des exceptions (exception safe) ainsi qu'une sécurité totale entre threads (thread-safe) ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Concernant la concurrence, cela signifie que des accès parallèles en lecture sur le même itérateur ou des instances indépendantes les unes des autres peuvent être exécutés sans mesures de synchronisation supplémentaires.

Parcours d'utilisation

Le chemin d'utilisation typique comprend le parcours itératif d'un ensemble de données d'éléments SOVD au sein de routines de traitement de diagnostic. Un appelant vérifie d'abord via l'opérateur d'inégalité operator!= ([SWS_DM_02268]) ou l'opérateur d'égalité operator== ([SWS_DM_02267]) si la fin de la séquence a été atteinte. Tant que l'itérateur est valide, l'application accède en lecture à l'élément référencé : l'opérateur de déréférencement operator* fournit une référence constante vers DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]), tandis que l'opérateur flèche operator-> renvoie un pointeur vers l'objet constant ([SWS_DM_02266]). Ensuite, l'opérateur d'incrémentation préfixée operator++ fait avancer l'itérateur d'une position et renvoie une référence vers l'itérateur incrémenté ([SWS_DM_02269]).

Diagramme de séquence : déroulement typique du parcours séquentiel d'éléments de contenu d'un enregistrement SOVD au moyen de l'itérateur constant. Sources : [SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]

Scénarios d'erreur

Toutes les fonctions membres de ara::diag::DiagnosticSovdRecordContentElementDataConstIterator sont déclarées avec le spécificateur noexcept ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Ni operator*, ni operator->, ni les opérateurs de comparaison ne lèvent d'exceptions C++ ou ne renvoient de structures d'erreur ara::core::Result. La précondition pour un appel sans erreur de operator*, operator-> et operator++ est la validité de l'itérateur : le déréférencement ou l'avancement d'un itérateur de fin (past-the-end) devrait conduire à un comportement indéfini (interprétation : la définition de l'interface ne contient aucun contrôle à l'exécution pour les déréférencements non valides). Question Q-e26c9aa50597bf18 (ouverte) Les utilisateurs doivent donc s'assurer qu'une comparaison d'interruption par rapport à l'itérateur de fin est systématiquement effectuée avant tout accès.