class ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

Die Klasse ara::diag::DiagnosticSovdRecordContentElementDataConstIterator fungiert gemäß [SWS_DM_02264] als konstanter Vorwärts-Iterator zur schreibgeschützten Traversierung von SOVD-Record-Inhaltselementen. Er bietet Operatoren für Gleichheitsprüfungen, Weiterschalten sowie die Dereferenzierung auf DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]). Da alle Operatoren ausnahmesicher und thread-safe nach noexcept ausgeführt sind, liegt die Verantwortung beim Aufrufer, keine ungültigen Iteratoren zu dereferenzieren.

mehr ›

Kontext

Die Klasse ara::diag::DiagnosticSovdRecordContentElementDataConstIterator wird durch [SWS_DM_02264] in AUTOSAR_AP_SWS_Diagnostics §8.60.8 definiert. Sie dient als konstanter Vorwärts- bzw. Eingabe-Iterator für Elemente des Typs DiagnosticSovdRecordContentElementData, wie in AUTOSAR_AP_SWS_Diagnostics §8.60.8 beschrieben. Als Interaktionspartner fungieren dabei diagnostische Anwendungen des Moduls diag, die Sammlungen von SOVD-Datenelementen („Service-Oriented Vehicle Diagnostics“) schreibgeschützt durchlaufen, sowie die referenzierten Elemente des Typs DiagnosticSovdContentElementDataWithKey, auf die der Iterator während der Dereferenzierung Zugriff gewährt ([SWS_DM_02265], [SWS_DM_02266]).

Lebenszyklus

Der Lebenszyklus eines Iterators beginnt typischerweise mit dem Abruf einer Iterator-Instanz über die Schnittstelle einer zugrundeliegenden Datenstruktur für SOVD-Record-Elemente (Interpretation: Container besitzen vermutlich Methoden wie cbegin() und cend(), die gültige Iteratorexemplare bereitstellen). Frage Q-9c5e4d32ae82e7cf (offen) Da es sich um einen reinen Wert- bzw. Zeiger-Wrapper ohne dynamische Ressourcenverwaltung handelt, besitzt der Iterator keinen expliziten Zerstörungsmechanismus und kann kopiert oder verschoben werden. Die Spezifikation sichert für alle Operationen des Iterators Ausnahmesicherheit (exception safe) sowie vollständige Thread-Sicherheit (thread-safe) zu ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Hinsichtlich der Nebenläufigkeit bedeutet dies, dass parallele Lesezugriffe auf denselben Iterator oder voneinander unabhängige Instanzen ohne zusätzliche Synchronisationsmaßnahmen durchgeführt werden können.

Nutzungspfad

Der typische Nutzungspfad umfasst die iterative Traversierung einer Menge von SOVD-Elementdaten innerhalb diagnostischer Verarbeitungsroutinen. Ein Aufrufer prüft zunächst über den Ungleichheitsoperator operator!= ([SWS_DM_02268]) oder den Gleichheitsoperator operator== ([SWS_DM_02267]), ob das Ende der Sequenz erreicht wurde. Solange der Iterator gültig ist, greift die Anwendung lesend auf das referenzierte Element zu: Der Dereferenzierungsoperator operator* liefert eine konstante Referenz auf DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]), während der Pfeiloperator operator-> einen Zeiger auf das konstante Objekt zurückgibt ([SWS_DM_02266]). Anschließend rückt der Präfix-Inkrementoperator operator++ den Iterator um eine Position weiter und gibt eine Referenz auf den inkrementierten Iterator zurück ([SWS_DM_02269]).

Sequenzdiagramm: Typischer Ablauf der sequenziellen Traversierung von SOVD-Record-Inhaltselementen mittels des Const-Iterators. Quellen: [SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]

Fehlerszenarien

Sämtliche Elementfunktionen von ara::diag::DiagnosticSovdRecordContentElementDataConstIterator sind mit dem Spezifizierer noexcept deklariert ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Weder operator* noch operator-> oder die Vergleichsoperatoren werfen C++-Ausnahmen oder geben ara::core::Result-Fehlerstrukturen zurück. Die Vorbedingung für einen fehlerfreien Aufruf von operator*, operator-> und operator++ ist die Gültigkeit des Iterators: Die Dereferenzierung oder das Weiterschalten eines End-Iterators (Past-the-End) dürfte zu undefiniertem Verhalten führen (Interpretation: die Schnittstellendefinition enthält keine Laufzeitprüfungen für ungültige Dereferenzierungen). Frage Q-e26c9aa50597bf18 (offen) Anwender müssen daher sicherstellen, dass vor dem Zugriff stets ein Abbruchvergleich gegen den End-Iterator erfolgt.