DEENESPTFRRUARHIKOZHNL

klasse ara::diag::DiagnosticServiceDynamicAccessList

[SWS_DM_01156] Upstream: RS_Diag_04251

class DiagnosticServiceDynamicAccessList final {...};

Definition of the DiagnosticServiceDynamicAccessList class, which is used by the application to build a DynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

User GuideAI-GEGENEREERD

Stelt adaptieve applicaties in staat dynamische toegangslijsten en servicepatronen voor diagnosediensten op te bouwen.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: d14f1d69eb64 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Stelt adaptieve applicaties in staat dynamische toegangslijsten en servicepatronen voor diagnosediensten op te bouwen.

De klasse dient voor adaptieve applicaties om dynamische toegangslijsten voor diagnosediensten aan te maken en te configureren [SWS_DM_01156]. Na optionele voorafgaande allocatie van geheugen creëert zij via methoden zoals MakeServiceBuilder instanties voor patroondefinitie van afzonderlijke service-ID's of byte-sequenties [SWS_DM_01164]. Alle lidfuncties zijn als noexcept uitzonderingsveilig gedeclareerd, terwijl modificerende operaties applicatiezijdig moeten worden beschermd tegen gelijktijdige toegang [SWS_DM_01163].

Context

De klasse ara::diag::DiagnosticServiceDynamicAccessList dient voor een adaptieve applicatie (AA) om een dynamische toegangslijst (DynamicAccessList) voor diagnosediensten op te bouwen [SWS_DM_01156]. Zij fungeert als factory en beheereenheid voor servicepatronen door instanties van DynamicAccessListDiagServiceBuilder aan te maken [SWS_DM_01164], [SWS_DM_01165]. In de architectuur interacteert de applicatie direct met de lijst om toegangsregels te definiëren aan de hand van service-ID's (SID) of byte-sequenties, welke de basis vormen voor de dynamische toegangscontrole in het diagnosesubsysteem SWS Diagnostics §8.13.1 “Class: DiagnosticServiceDynamicAccessList”.

Levenscyclus

Instanties van DiagnosticServiceDynamicAccessList worden aangemaakt via de parameterloze standaardconstructor [SWS_DM_01157]. De klasse is gedeclareerd als final SWS Diagnostics §8.13.1 “Class: DiagnosticServiceDynamicAccessList”. Zij ondersteunt volwaardige waardesemantiek: objecten kunnen zowel worden gekopieerd als verplaatst, waarvoor corresponderende kopieer- en move-constructors [SWS_DM_01159], [SWS_DM_01160] evenals toewijzingsoperatoren [SWS_DM_01161], [SWS_DM_01162] beschikbaar zijn. Na de initialisatie bevindt het object zich in de toestand voor patroonopname, voordat het aan het einde van zijn levensduur via de destructor wordt opgeruimd [SWS_DM_01158].

Met betrekking tot gelijktijdigheid zijn de constructors (standaard-, kopieer- en move-constructor) expliciet als thread-safe gespecificeerd [SWS_DM_01157], [SWS_DM_01159], [SWS_DM_01160]. Alle manipulerende methoden zoals toewijzingen, geheugenreserveringen en builder-creaties, evenals de destructor, zijn daarentegen gedefinieerd als niet-thread-safe [SWS_DM_01161], [SWS_DM_01162], [SWS_DM_01163], [SWS_DM_01164], [SWS_DM_01165], [SWS_DM_01158]. Gelijktijdige toegang tot hetzelfde object vereist derhalve synchronisatie aan de applicatiezijde.

Gebruikspad

Het typische verloop bij de opbouw van een dynamische servicetoegangslijst omvat de volgende fasen:

  • Voorafgaande geheugenallocatie: Voorafgaand aan het toevoegen van servicepatronen kan de applicatie met Reserve vooraf geheugen reserveren voor alle verwachte servicepatronen [SWS_DM_01163]. De meegegeven parameters numberOfServiceHeads en maxServiceHeadSize maken een worstcaseschatting van het benodigde geheugen mogelijk om latere dynamische herallocaties te minimaliseren.
  • Aanmaken van patronen: De applicatie roept MakeServiceBuilder aan om een diagnosedienstpatroon te initiëren. Dit gebeurt ofwel aan de hand van een enkele SID-byte [SWS_DM_01164] ofwel van een byte-sequentie serviceHead voor diepgaandere patrooncontroles [SWS_DM_01165].
  • Patroonconfiguratie: De methode levert een object van het type DynamicAccessListDiagServiceBuilder op [SWS_DM_01164], dat de applicatie vervolgens configureert.
Nutzungsablauf von DiagnosticServiceDynamicAccessListAADiagnosticServiceDynamicAccessListDynamicAccessListDiagServiceBuilderReserve(numberOfServiceHeads, maxServiceHeadSize)altEnkele service (alleen SID)MakeServiceBuilder(sid)Musterabgleich (Byte-Sequenz)MakeServiceBuilder(serviceHead)Instantiëring van de builderTeruggave DynamicAccessListDiagServiceBuilder

Sequentiediagram: Typisch verloop van het aanmaken van patronen via DiagnosticServiceDynamicAccessList. Bronnen: [SWS_DM_01163], [SWS_DM_01164], [SWS_DM_01165]

Foutscenario's

Alle openbare memberfuncties en constructors van de klasse zijn als noexcept gedeclareerd en garanderen strikte uitzonderingsveiligheid (exception safe) [SWS_DM_01157], [SWS_DM_01163], [SWS_DM_01164]. Fouttoestanden in de vorm van C++-exceptions of teruggave van ara::core::Result met foutcodes treden op deze interface niet op. Bij de geheugenreservering via Reserve mag de opgave een schatting zijn; een onderschatting leidt niet tot het afbreken van de functie, maar zal vermoedelijk latere herallocaties noodzakelijk maken [SWS_DM_01163]. Vraag Q-8d33a0315da27aed (open) Applicatieontwikkelaars moeten ervoor zorgen dat de niet-thread-safe functies Reserve, MakeServiceBuilder en de toewijzingsoperatoren nooit zonder externe vergrendeling gelijktijdig met hetzelfde object worden uitgevoerd.

Deze handleiding is gebaseerd op de AUTOSAR-standaard Release R25-11 en vat de specificatie van de klasse ara::diag::DiagnosticServiceDynamicAccessList samen.

Ledenkaart

Klassendiagram

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__DiagnosticServiceDynamicAccessList408 DiagnosticServiceDynamicAccessList + DiagnosticServiceDynamicAccessList() + ~DiagnosticServiceDynamicAccessList() + MakeServiceBuilder() + Reserve() + operator=()

Detailweergave

Kies een item in de inhoudsopgave.

Constructors en destructor

Constructor of DiagnosticServiceDynamicAccessList.

Overloads DiagnosticServiceDynamicAccessList 3
DiagnosticServiceDynamicAccessList () noexcept; SWS_DM_01157
DiagnosticServiceDynamicAccessList (DiagnosticServiceDynamicAccessList const &other) noexcept; SWS_DM_01159
DiagnosticServiceDynamicAccessList (DiagnosticServiceDynamicAccessList &&other) noexcept; SWS_DM_01160

Destructor of DiagnosticServiceDynamicAccessList.

Methoden

This function is used by the AA to construct a pattern for the DynamicAccessList, using only the SID.

Overloads MakeServiceBuilder 2
auto MakeServiceBuilder (DynamicAccessListDiagServiceBuilder::Byte String serviceHead) noexcept -> DynamicAccessListDiagServiceBuilder; SWS_DM_01165
Reserve functie

Preallocates memory for all service heads to fit into the DynamicAccessList. The preallocation can be just estimated and may calculate just the worst case of memory needed, not exact memory size needed for data numberOfServiceHeads.

void Reserve (std::size_t numberOfServiceHeads, std::size_t maxService HeadSize) noexcept;

Operatoren

operator= functie 2

Copy assignment operator of DiagnosticServiceDynamicAccessList.

Overloads = 2

Documentatie van de methoden

functie DiagnosticServiceDynamicAccessList [SWS_DM_01157] Upstream: RS_Diag_04251

DiagnosticServiceDynamicAccessList () noexcept;

Constructor of DiagnosticServiceDynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01157
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01157@rel:R25-11#e5354248
Content hash
e5354248
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01157
Status: valid/unmigrated Version: rel:R25-11#650f2a0d Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01157@rel:R25-11#650f2a0d
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#42df3dfe2026-09-30
  • R21-11rel:R21-11#09c51dc72026-10-14
  • R22-11rel:R22-11#113ea8dc2026-10-14
  • R23-11rel:R23-11#4acd84372026-10-14
  • R24-11rel:R24-11#9677d51c2026-10-14
  • R25-11rel:R25-11#650f2a0d2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie DiagnosticServiceDynamicAccessList [SWS_DM_01159] Upstream: RS_Diag_04251

DiagnosticServiceDynamicAccessList (DiagnosticServiceDynamicAccessList const &other) noexcept;

Copy constructor of DiagnosticServiceDynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
otherObject to copy-construct from

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01159
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01159@rel:R25-11#e1006679
Content hash
e1006679
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01159
Status: valid/unmigrated Version: rel:R25-11#5af28b9b Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01159@rel:R25-11#5af28b9b
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#04f2998d2026-09-30
  • R21-11rel:R21-11#512324732026-10-14
  • R22-11rel:R22-11#cb06a8392026-10-14
  • R23-11rel:R23-11#0c46643c2026-10-14
  • R24-11rel:R24-11#68d000522026-10-14
  • R25-11rel:R25-11#5af28b9b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie DiagnosticServiceDynamicAccessList [SWS_DM_01160] Upstream: RS_Diag_04251

DiagnosticServiceDynamicAccessList (DiagnosticServiceDynamicAccessList &&other) noexcept;

Move constructor of DiagnosticServiceDynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
otherObject to move-construct from

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01160
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01160@rel:R25-11#c1b9a8b3
Content hash
c1b9a8b3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01160
Status: valid/unmigrated Version: rel:R25-11#12aff0c0 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01160@rel:R25-11#12aff0c0
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#b1d30f912026-09-30
  • R21-11rel:R21-11#7324eeed2026-10-14
  • R22-11rel:R22-11#fe02969e2026-10-14
  • R23-11rel:R23-11#50b95efd2026-10-14
  • R24-11rel:R24-11#f4a6a02c2026-10-14
  • R25-11rel:R25-11#12aff0c02026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie MakeServiceBuilder [SWS_DM_01164] Upstream: RS_Diag_04251

auto MakeServiceBuilder (DynamicAccessListDiagServiceBuilder::Byte sid) noexcept -> DynamicAccessListDiagServiceBuilder;

This function is used by the AA to construct a pattern for the DynamicAccessList, using only the SID.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: cfdb5e234f29 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De synchrone functie MakeServiceBuilder van de klasse ara::diag::DiagnosticServiceDynamicAccessList dient er voor een adaptieve applicatie toe om een patroon voor de dynamische toegangslijst (DynamicAccessList) via een afzonderlijke service-identifier (sid) te initiëren ([SWS_DM_01164]). Ze accepteert de parameter sid van het type DynamicAccessListDiagServiceBuilder::Byte en retourneert een nieuwe instantie van DynamicAccessListDiagServiceBuilder ([SWS_DM_01164]). Door deze aanroep brengt de applicatie de Diagnostic Server-instantie ertoe een nieuwe DynamicAccessList op te bouwen, beginnend met het overgedragen enkelbytepatroon ([SWS_DM_01218]; AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.4 “DynamicAccessList Creation and Update”).

Interactie en alternatieven

Na het starten is de dynamische toegangslijst van alle clients standaard leeg ([SWS_DM_01214]). Naast deze functie staat ter beschikking van de applicatie een overbelasting met een bytestring (serviceHead) ([SWS_DM_01165]). Beide overbelastingen vormen het instappunt waarmee het aanmaken van een nieuwe toegangslijst in de server in gang wordt gezet ([SWS_DM_01218]).

Foutafhandeling en gelijktijdigheid

De interface is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) ([SWS_DM_01164]). Ze werpt geen uitzonderingen op en geeft geen foutcodes terug; foutieve service-identifiers vallen daarom vermoedelijk pas op bij de latere evaluatie van het patroon door de Diagnostic Server. Vraag Q-eacef79ec6be9fcd (open) Met betrekking tot gelijktijdigheid is de functie expliciet geclassificeerd als niet-draadveilig (not thread-safe) ([SWS_DM_01164]). Bij parallelle toegang vanuit meerdere uitvoeringscontexten moet de aanroepende applicatie zorgen voor een externe synchronisatie.

Deze gebruiksinstructie is gegenereerd door een AI op basis van de AUTOSAR-specificatie R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
sidThe diagnostic service identifier

Rückgabewert

TypBeschreibung
DynamicAccessListDiagServiceBuilderReturns an instance of a diagnostic service pattern builder.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01164
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01164@rel:R25-11#4030af49
Content hash
4030af49
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01164
Status: valid/unmigrated Version: rel:R25-11#3c379a56 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01164@rel:R25-11#3c379a56
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#1eac24272026-09-30
  • R21-11rel:R21-11#230b7fcc2026-10-14
  • R22-11rel:R22-11#afc594cf2026-10-14
  • R23-11rel:R23-11#9cb67f682026-10-14
  • R24-11rel:R24-11#6c185f572026-10-14
  • R25-11rel:R25-11#3c379a562026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie MakeServiceBuilder [SWS_DM_01165] Upstream: RS_Diag_04251

auto MakeServiceBuilder (DynamicAccessListDiagServiceBuilder::Byte String serviceHead) noexcept -> DynamicAccessListDiagServiceBuilder;

This function is used by the AA to construct a pattern for the DynamicAccessList, using a string of bytes.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 7426838ef9df Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De methode MakeServiceBuilder van de klasse ara::diag::DiagnosticServiceDynamicAccessList dient er voor een Adaptive Application toe om een diagnosepatroon voor de DynamicAccessList aan te maken aan de hand van een bytereeks ([SWS_DM_01165]).

Gebruik

De aanroep geschiedt synchroon via de interface van de klasse ara::diag::DiagnosticServiceDynamicAccessList (AUTOSAR_AP_SWS_Diagnostics §8.13.1.1.3.1 “MakeServiceBuilder”):

  • Parameter: serviceHead (type DynamicAccessListDiagServiceBuilder::Byte String) draagt een bytereeks over die het begin van het patroon voor de diagnosevergelijking definieert ([SWS_DM_01165]).
  • Retourwaarde: Retourneert een instantie van DynamicAccessListDiagServiceBuilder voor de verdere vormgeving van het servicepatroon ([SWS_DM_01165]).

Zusammenspiel en levenscyclus

Bij het opstarten van het systeem is de DynamicAccessList van alle clients standaard leeg ([SWS_DM_01214]). Wordt een overbelasting van MakeServiceBuilder aangeroepen, dan brengt de Diagnostic Server-instantie de aanmaak van een nieuwe DynamicAccessList teweeg, beginnend met het overgedragen bytestring-patroon ([SWS_DM_01218], AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.4 “DynamicAccessList Creation and Update”). Als alternatief is een overbelasting voor een enkele byte beschikbaar ([SWS_DM_01164]).

Gelijktijdigheid en foutafhandeling

De functie is gedeclareerd als noexcept en uitzonderingsveilig (exception safe), produceert dus geen C++-exceptions ([SWS_DM_01165]). Foutcodes of DET-/DEM-meldingen zijn voor deze aanroep niet gespecificeerd. Omdat de operatie is geclassificeerd als niet-draadveilig (not thread-safe), moeten parallelle aanroepen op dezelfde instantie aan applicatiezijde worden gesynchroniseerd ([SWS_DM_01165]).

Deze gebruiksinstructie is gegenereerd door een AI op basis van de AUTOSAR-specificatie R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
serviceHeadA string of bytes to start the DynamicAccess pattern-match

Rückgabewert

TypBeschreibung
DynamicAccessListDiagServiceBuilderReturns an instance of a diagnostic service pattern builder

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01165
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01165@rel:R25-11#b1601a8b
Content hash
b1601a8b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01165
Status: valid/unmigrated Version: rel:R25-11#4638ae8b Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01165@rel:R25-11#4638ae8b
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#91e264c52026-09-30
  • R21-11rel:R21-11#a05ce1b82026-10-14
  • R22-11rel:R22-11#081641a52026-10-14
  • R23-11rel:R23-11#47836da72026-10-14
  • R24-11rel:R24-11#236438b42026-10-14
  • R25-11rel:R25-11#4638ae8b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Reserve [SWS_DM_01163] Upstream: RS_Diag_04251

void Reserve (std::size_t numberOfServiceHeads, std::size_t maxService HeadSize) noexcept;

Preallocates memory for all service heads to fit into the DynamicAccessList. The preallocation can be just estimated and may calculate just the worst case of memory needed, not exact memory size needed for data numberOfServiceHeads.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 77bde14da8ee Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De methode ara::diag::DiagnosticServiceDynamicAccessList::Reserve alloceert vooraf geheugen voor service-heads binnen een instantie van DiagnosticServiceDynamicAccessList ([SWS_DM_01163], SWS Diagnostics §8.13.1.1.3.3 “Reserve”). Deze voorafgaande allocatie hoeft niet de exacte geheugengrootte te treffen, maar mag berekend worden als een worst-case-schatting van het maximaal benodigde geheugen ([SWS_DM_01163]).

Gebruik en parameters

De aanroep geschiedt synchroon en verwerkt twee invoerparameters ([SWS_DM_01163]):

  • numberOfServiceHeads (std::size_t): Aantal diagnostische servicepatronen (patterns).
  • maxServiceHeadSize (std::size_t): Verwacht maximaal aantal diagnosebytes binnen een afzonderlijk patroon.

De functie levert geen retourwaarde op (void) en is gespecificeerd met noexcept evenals de eigenschap exception safe ([SWS_DM_01163]). Een foutafhandeling via retourcodes of uitzonderingen bestaat niet.

Gelijktijdigheid en beperkingen

De functie is geclassificeerd als not thread-safe ([SWS_DM_01163]). Gelijktijdige toegangen van meerdere threads tot dezelfde instantie vereisen daarom dwingend een externe synchronisatie. Vermoedelijk wordt de methode aangeroepen voorafgaand aan het registreren van service-patterns om latere geheugen-herallocaties tijdens runtime te minimaliseren. Vraag Q-e58b6f12a3a0adac (open)

Afbakening

Deze methode moet worden onderscheiden van gelijknamige SOVD-functies zoals in DiagnosticSovdArrayContentElementDataView ([SWS_DM_02240]), DiagnosticSovdRecordContentElementDataView ([SWS_DM_02283]) of DiagnosticSovdContentElementData ([SWS_DM_02345]), die telkens een capaciteit accepteren en gespecificeerd zijn als thread-safe.

Deze gebruiksinstructie is gebaseerd op de specificatie AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
numberOfServiceHeadsThe number of diagnostic service patterns.
maxServiceHeadSizeThe expected maximum number of diagnostic service bytes in a single pattern.

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01163
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01163@rel:R25-11#c4d00cd4
Content hash
c4d00cd4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01163
Status: valid/unmigrated Version: rel:R25-11#231ea52a Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01163@rel:R25-11#231ea52a
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#4f6a02da2026-09-30
  • R21-11rel:R21-11#7c00aaff2026-10-14
  • R22-11rel:R22-11#9b2d4beb2026-10-14
  • R23-11rel:R23-11#39885db92026-10-14
  • R24-11rel:R24-11#c550adcb2026-10-14
  • R25-11rel:R25-11#231ea52a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie operator= [SWS_DM_01161] Upstream: RS_Diag_04251

auto operator= (DiagnosticServiceDynamicAccessList const &other) & noexcept -> DiagnosticServiceDynamicAccessList &;

Copy assignment operator of DiagnosticServiceDynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
otherObject to copy-assign from.

Rückgabewert

TypBeschreibung
DiagnosticServiceDynamicAccessListDiagnosticService DynamicAccessList& Reference to self.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01161
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01161@rel:R25-11#2c97b597
Content hash
2c97b597
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01161
Status: valid/unmigrated Version: rel:R25-11#bce030a7 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01161@rel:R25-11#bce030a7
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#92a7fbd62026-09-30
  • R21-11rel:R21-11#827b61ac2026-10-14
  • R22-11rel:R22-11#b8b5ca432026-10-14
  • R23-11rel:R23-11#df8cf67a2026-10-14
  • R24-11rel:R24-11#d76fed172026-10-14
  • R25-11rel:R25-11#bce030a72026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie operator= [SWS_DM_01162] Upstream: RS_Diag_04251

auto operator= (DiagnosticServiceDynamicAccessList &&other) & noexcept -> DiagnosticServiceDynamicAccessList &;

Move assignment operator of DiagnosticServiceDynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Parameter (in)

ParameterBeschreibung
otherObject to move-assign from.

Rückgabewert

TypBeschreibung
DiagnosticServiceDynamicAccessListDiagnosticService DynamicAccessList& Reference to self.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01162
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01162@rel:R25-11#5c17d048
Content hash
5c17d048
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01162
Status: valid/unmigrated Version: rel:R25-11#45605241 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01162@rel:R25-11#45605241
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#aeb26d702026-09-30
  • R21-11rel:R21-11#13f622882026-10-14
  • R22-11rel:R22-11#2543a3962026-10-14
  • R23-11rel:R23-11#66dedb2b2026-10-14
  • R24-11rel:R24-11#02a7987a2026-10-14
  • R25-11rel:R25-11#456052412026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie ~DiagnosticServiceDynamicAccessList [SWS_DM_01158] Upstream: RS_Diag_04251

~DiagnosticServiceDynamicAccessList () noexcept;

Destructor of DiagnosticServiceDynamicAccessList.

Header-Datei#include "ara/diag/diagnostic_service_dynamic_access_list.h"
Scopeclass ara::diag::DiagnosticServiceDynamicAccessList
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01158
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01158@rel:R25-11#52552ab0
Content hash
52552ab0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01158
Status: valid/unmigrated Version: rel:R25-11#dfc56fdd Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01158@rel:R25-11#dfc56fdd
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#d795d66e2026-09-30
  • R21-11rel:R21-11#5abdb5112026-10-14
  • R22-11rel:R22-11#c2b638722026-10-14
  • R23-11rel:R23-11#606ce0002026-10-14
  • R24-11rel:R24-11#f7853b742026-10-14
  • R25-11rel:R25-11#dfc56fdd2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill