klasse ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

De klasse ara::diag::DiagnosticSovdRecordContentElementDataConstIterator fungeert conform [SWS_DM_02264] als constante forward-iterator voor de alleen-lezen traversering van SOVD-record-inhoudselementen. Deze biedt operatoren voor gelijkheidscontroles, doorschakelen en dereferentie naar DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]). Aangezien alle operatoren uitzonderingsveilig en thread-safe volgens noexcept zijn uitgevoerd, ligt de verantwoordelijkheid bij de aanroeper om geen ongeldige iterators te derefereren.

meer ›

Context

De klasse ara::diag::DiagnosticSovdRecordContentElementDataConstIterator wordt gedefinieerd door [SWS_DM_02264] in AUTOSAR_AP_SWS_Diagnostics §8.60.8. Deze dient als constante forward- respectievelijk input-iterator voor elementen van het type DiagnosticSovdRecordContentElementData, zoals beschreven in AUTOSAR_AP_SWS_Diagnostics §8.60.8. Als interactiepartners fungeren daarbij diagnostische applicaties van de module diag, die verzamelingen van SOVD-data-elementen (“Service-Oriented Vehicle Diagnostics”) alleen-lezen doorlopen, evenals de gereferentieerde elementen van het type DiagnosticSovdContentElementDataWithKey waartoe de iterator tijdens de dereferentie toegang verleent ([SWS_DM_02265], [SWS_DM_02266]).

Levenscyclus

De levenscyclus van een iterator begint typisch met het opvragen van een iterator-instantie via de interface van een onderliggende datastructuur voor SOVD-record-elementen (interpretatie: containers bezitten vermoedelijk methoden zoals cbegin() en cend() die geldige iteratorexemplaren beschikbaar stellen). Vraag Q-9c5e4d32ae82e7cf (open) Aangezien het om een zuivere waarde- respectievelijk pointer-wrapper zonder dynamisch resourcebeheer gaat, bezit de iterator geen expliciet vernietigingsmechanisme en kan deze worden gekopieerd of verplaatst. De specificatie garandeert voor alle operaties van de iterator uitzonderingsveiligheid (exception safe) evenals volledige thread-safety (thread-safe) ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Met betrekking tot concurrency betekent dit dat parallelle leestoegangen op dezelfde iterator of op van elkaar onafhankelijke instanties zonder aanvullende synchronisatiemaatregelen kunnen worden uitgevoerd.

Gebruikspad

Het typische gebruikstraject omvat de iteratieve traversering van een verzameling SOVD-elementdata binnen diagnostische verwerkingsroutines. Een aanroeper controleert eerst via de ongelijkheidsoperator operator!= ([SWS_DM_02268]) of de gelijkheidsoperator operator== ([SWS_DM_02267]) of het einde van de reeks is bereikt. Zolang de iterator geldig is, benadert de applicatie het gereferentieerde element lezend: de dereferentie-operator operator* levert een constante referentie naar DiagnosticSovdContentElementDataWithKey op ([SWS_DM_02265]), terwijl de pijl-operator operator-> een pointer naar het constante object retourneert ([SWS_DM_02266]). Vervolgens schuift de prefix-increment-operator operator++ de iterator één positie op en geeft een referentie naar de geïncrementeerde iterator terug ([SWS_DM_02269]).

Sequentiediagram: Typisch verloop van de sequentiële traversering van SOVD-record-inhoudselementen via de const-iterator. Bronnen: [SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]

Foutscenario's

Alle lidfuncties van ara::diag::DiagnosticSovdRecordContentElementDataConstIterator zijn gedeclareerd met de specificator noexcept ([SWS_DM_02265], [SWS_DM_02266], [SWS_DM_02267], [SWS_DM_02268], [SWS_DM_02269]). Noch operator*, noch operator-> of de vergelijkingsoperatoren werpen C++-excepties of geven ara::core::Result-foutstructuren terug. De voorwaarde voor een foutloze aanroep van operator*, operator-> en operator++ is de geldigheid van de iterator: de dereferentie of het doorschakelen van een end-iterator (past-the-end) leidt vermoedelijk tot ongedefinieerd gedrag (interpretatie: de interfacedefinitie bevat geen runtime-controles voor ongeldige dereferenties). Vraag Q-e26c9aa50597bf18 (open) Gebruikers moeten er daarom voor zorgen dat voorafgaand aan de toegang altijd een afbreekvergelijking met de end-iterator plaatsvindt.