class ara::diag::DiagnosticSovdRecordContentElementDataIterator

Die Klasse ara::diag::DiagnosticSovdRecordContentElementDataIterator dient als Iterator zum sequenziellen Durchlaufen von Diagnose-Datenelementen einer SOVD-Aufzeichnung ([SWS_DM_02258]). Über die Dereferenzierungsoperatoren erhalten Anwendungen Zugriff auf Elemente des Typs DiagnosticSovdContentElementDataWithKey, während das Vorwärtsschreiten mittels Inkrementoperator erfolgt. Als zentrale Randbedingung sind alle Funktionen als noexcept und threadsicher spezifiziert ([SWS_DM_02263]). Interpretation: Die aufrufende Anwendung muss vor jedem Zugriff eigenständig prüfen, ob das Sequenzende erreicht ist, um undefiniertes Verhalten zu verhindern. Frage Q-819b2e03155473ad (offen)

mehr ›

Kontext

Die Klasse ara::diag::DiagnosticSovdRecordContentElementDataIterator ist in der AUTOSAR Adaptive Platform als Iterator für Datenelemente von SOVD-Aufzeichnungen (Service-Oriented Vehicle Diagnostics) spezifiziert ([SWS_DM_02258], AUTOSAR_AP_SWS_Diagnostics §8.60.10 „Class: DiagnosticSovdRecordContentElementDataIterator“). Innerhalb des Diagnose-Subsystems dient sie als standardisierte Zugriffsschnittstelle, um strukturierte Diagnosedaten einer SOVD-Aufzeichnung elementweise zu traversieren.

Zu den primären Interaktionspartnern gehört die anfordernde Diagnoseanwendung, welche Aufzeichnungsdaten verarbeitet, sowie die zugrunde liegende Datenstruktur des Diagnosemoduls. Der Iterator vermittelt den Zugriff auf einzelne Datenelemente des Typs DiagnosticSovdContentElementDataWithKey, indem er über seine Dereferenzierungsoperatoren wahlweise Referenzen oder Zeiger auf diese Datenelemente bereitstellt ([SWS_DM_02259], [SWS_DM_02260]).

Lebenszyklus

Instanzen des Iterators werden typischerweise bei Abfrageoperationen auf SOVD-Inhalten erzeugt. Die Spezifikation definiert für den Iterator keinen eigenständigen öffentlichen Konstruktor im API-Umfang; Instanzen dürften daher vornehmlich durch übergeordnete Container oder Abfragefunktionen bereitgestellt und als Werte kopiert werden. Frage Q-e79bbdff728ef3f2 (offen) Der Iterator verweist auf bestehende Nutzdaten, ohne deren Eigentümerschaft zu übernehmen.

Der Lebenszyklus innerhalb eines Traversierungsvorgangs wird durch Vorwärtsschritte und Positionsvergleiche gesteuert. Über den Präfix-Inkrementoperator operator++ wird der Iterator auf das nachfolgende Datenelement weitergeschaltet ([SWS_DM_02263]). Die Gültigkeit und das Erreichen des Sequenzendes werden über die Gleichheits- und Ungleichheitsoperatoren operator== ([SWS_DM_02261]) und operator!= ([SWS_DM_02262]) gegenüber einem Sentinel- oder End-Iterator ermittelt.

Hinsichtlich der Nebenläufigkeit sind sämtliche Mitgliedsfunktionen der Klasse explizit als threadsicher spezifiziert ([SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02261], [SWS_DM_02262], [SWS_DM_02263]). Dies gestattet parallele Lesezugriffe auf getrennte Iterator-Instanzen in Multithreading-Umgebungen.

Nutzungspfad

Der typische Ablauf bei der Auswertung von SOVD-Record-Inhalten folgt dem klassischen C++-Vorwärtsiterator-Muster:

• Prüfung der Abbruchbedingung: Vor jedem Zugriff vergleicht die Anwendung die aktuelle Position mit dem End-Iterator mittels operator!= ([SWS_DM_02262]).
• Elementzugriff: Steht der Iterator auf einem gültigen Element, greift die Anwendung entweder per Referenz über operator* auf das DiagnosticSovdContentElementDataWithKey zu ([SWS_DM_02259]) oder nutzt den Elementzugriffsoperator operator-> ([SWS_DM_02260]), um direkt Methoden oder Felder des Datenelements zu adressieren.
• Weiterschalten: Mittels operator++ wird der Iterator auf die nächste Position inkrementiert ([SWS_DM_02263]).

Sequenzdiagramm: Typischer Ablauf der Traversierung von SOVD-Record-Datenelementen. Quellen: [SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02262], [SWS_DM_02263].

Fehlerszenarien

Alle spezifizierten Operationen des Iterators sind als ausnahmesicher (exception safe) und als noexcept deklariert ([SWS_DM_02259], [SWS_DM_02260], [SWS_DM_02261], [SWS_DM_02262], [SWS_DM_02263]). Das bedeutet, dass im regulären Betrieb keine Exceptions geworfen werden und keine Fehlercodes zur Auswertung anfallen.

Interpretation: Als wesentliche Vorbedingung für die Aufrufe von operator*, operator-> und operator++ gilt, dass der Iterator eine gültige Position referenzieren muss und nicht dem End-Iterator entsprechen darf. Frage (offen) Ein Weiterschalten oder Dereferenzieren eines ungültigen Iterators dürfte im C++-Standardkontext zu undefiniertem Verhalten führen. Anwendungen müssen daher das Erreichen des Endes strikt mittels operator!= oder operator== abprüfen ([SWS_DM_02261], [SWS_DM_02262]).