klasse ara::diag::DiagnosticSovdArrayContentElementDataIterator

De klasse ara::diag::DiagnosticSovdArrayContentElementDataIterator dient voor de stapsgewijze iteratie over SOVD-array-elementen in diagnose-inhoud ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 “Class: DiagnosticSovdArrayContentElementDataIterator”). Deze biedt operatoren voor vergelijking, doorschakeling via prefix-increment en dereferentie om referenties of pointers naar DiagnosticSovdContentElementData te leveren ([SWS_DM_02216], [SWS_DM_02220]). Alle functies zijn thread-safe en gespecificeerd als noexcept, waardoor de geldigheid van het doelbereik vóór de dereferentie door de applicatie moet worden gewaarborgd.

meer ›

Context

De klasse ara::diag::DiagnosticSovdArrayContentElementDataIterator stelt een specifieke iterator voor array-elementen binnen de op SOVD gebaseerde diagnosecommunicatie (Service-Oriented Vehicle Diagnostics) beschikbaar ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 “Class: DiagnosticSovdArrayContentElementDataIterator”). Haar primaire verantwoordelijkheid ligt in het beschikbaar stellen van gestandaardiseerde iteratie-interfaces om sequentieel over elementen van een data-array te navigeren. Als interactiepartners treden aanroepende diagnose-applicaties en de gereferentieerde doelelementen van het type DiagnosticSovdContentElementData op ([SWS_DM_02216], [SWS_DM_02217]). De iterator is gedeclareerd in de header ara/diag/diagnostic_sovd_content_element_data.h (AUTOSAR_AP_SWS_Diagnostics §8.60.4.1 “Public Member Functions”).

Levenscyclus

De specificatie definieert voor ara::diag::DiagnosticSovdArrayContentElementDataIterator geen eigen openbare constructors; instanties worden derhalve door de desbetreffende SOVD-containerstructuren via hun iteratormethoden aangemaakt en beschikbaar gesteld (interpretatie). Vraag Q-e1fbf51ab4acc197 (open) De iterator zelf bezit geen eigendom over de onderliggende gebruikersdata, maar bevat louter verwijzingen naar de respectieve elementen in het geheugen. De geldigheid van een iterator-instantie is daarom vermoedelijk strikt gekoppeld aan de levensduur en geldigheid van de bovenliggende datastructuur (interpretatie). Vraag Q-c01219664b4adc56 (open)

Met betrekking tot de levenscyclus en de concurrency zijn alle lidfuncties als uitzonderingsveilig (exception safe) en thread-safe (thread-safe) gespecificeerd ([SWS_DM_02216], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Dit staat gelijktijdige lees- en doorschakeloperaties over meerdere threads heen toe, mits de onderliggende datastructuur niet concurrent destructief wordt gewijzigd.

Gebruikspad

Het reguliere verloop volgt het typische patroon van C++-forward-iterators. Applicaties vergelijken de actuele iteratorpositie met een end-iterator via operator!= ([SWS_DM_02219]) of operator== ([SWS_DM_02218], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.5 “operator==”). Als het einde nog niet is bereikt, vindt de leestoegang tot het actuele element plaats hetzij via de dereferentie operator* ([SWS_DM_02216]) om een referentie naar DiagnosticSovdContentElementData terug te geven, hetzij via de pijl-operator operator-> ([SWS_DM_02217], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.4 “operator->”) om een overeenkomstige pointer terug te geven. Vervolgens schakelt de applicatie de positie met de prefix-increment-operator operator++ door naar het volgende array-element ([SWS_DM_02220], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.3 “operator++”).

Sequentiediagram: Aanroepvolgorde tijdens een iteratielus over SOVD-array-elementen. Bronnen: [SWS_DM_02216], [SWS_DM_02219], [SWS_DM_02220].

Foutscenario's

Alle methoden van de iterator zijn voorzien van de specificatie noexcept en werpen per definitie geen excepties ([SWS_DM_02216], [SWS_DM_02217], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220]). Foutcodes zoals ara::core::ErrorCode zijn voor deze interfaces niet voorzien. De correctheid is de verantwoordelijkheid van de aanroepvoorwaarden van de applicatie: een dereferentie via operator* of operator-> vereist als strikte voorwaarde dat de iterator naar een geldig array-element en niet naar de end-positie verwijst; toegang tot ongeldige iterators leidt vermoedelijk tot ongedefinieerd gedrag (interpretatie). Vraag Q-63d87e38f9886f6b (open)