DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DiagnosticSovdRecordContentElementDataIterator

[SWS_DM_02258] Upstream: RS_Diag_04260

class DiagnosticSovdRecordContentElementDataIterator {...};

Iterator for a DiagnosticSovdRecordContentElementData.

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

دليل المستخدممولَّد بالذكاء الاصطناعي

يُستخدم للمرور التسلسلي وقراءة عناصر البيانات التشخيصية ضمن تسجيل SOVD.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 656c1be3725e المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يُستخدم للمرور التسلسلي وقراءة عناصر البيانات التشخيصية ضمن تسجيل SOVD.

تُستخدم الفئة ara::diag::DiagnosticSovdRecordContentElementDataIterator كمكرر للمرور التسلسلي عبر عناصر البيانات التشخيصية لتسجيل SOVD ([SWS_DM_02258]). وعبر عوامل إلغاء المرجعية، تحصل التطبيقات على وصول إلى عناصر من النوع DiagnosticSovdContentElementDataWithKey، بينما يتم التقدم إلى الأمام بواسطة عامل التزايد. وكنتيجة قيد أساسية، تم تحديد جميع الدوال على أنها noexcept وآمنة بالنسبة للخيوط ([SWS_DM_02263]). تفسير: يجب على التطبيق المستدعي التحقق بشكل مستقل قبل كل وصول مما إذا كان قد تم الوصول إلى نهاية التسلسل، لمنع حدوث سلوك غير محدد. سؤال Q-819b2e03155473ad (مفتوح)

السياق

تم تحديد الفئة ara::diag::DiagnosticSovdRecordContentElementDataIterator في AUTOSAR Adaptive Platform كمكرر لعناصر بيانات تسجيلات SOVD (Service-Oriented Vehicle Diagnostics) ([SWS_DM_02258]، AUTOSAR_AP_SWS_Diagnostics §8.60.10 «Class: DiagnosticSovdRecordContentElementDataIterator»). وضمن النظام الفرعي لـ Diagnostics، تعمل كواجهة وصول قياسية لاجتياز البيانات التشخيصية المهيكلة لتسجيل SOVD عنصرًا بعنصر.

تشمل أطراف التفاعل الأساسية تطبيق التشخيص الطالب، الذي يعالج بيانات التسجيل، بالإضافة إلى بنية البيانات الأساسية لوحدة التشخيص. يتيح المكرر الوصول إلى عناصر بيانات مفردة من النوع DiagnosticSovdContentElementDataWithKey، وذلك من خلال توفير مراجع أو مؤشرات إلى عناصر البيانات هذه اختياريًا عبر عوامل إلغاء المرجعية الخاصة به ([SWS_DM_02259]، [SWS_DM_02260]).

دورة الحياة

يتم إنشاء حالات المكرر عادةً أثناء عمليات الاستعلام عن محتويات SOVD. لا تحدد المواصفة منشئًا عامًا مستقلاً للمكرر ضمن نطاق API؛ لذلك من المرجح أن يتم توفير الحالات بشكل أساسي بواسطة حاويات أو دوال استعلام عليا وتُنسخ كقيم. سؤال Q-e79bbdff728ef3f2 (مفتوح) يشير المكرر إلى بيانات حمولة موجودة دون أن يتولى ملكيتها.

تتم إدارة دورة الحياة ضمن عملية الاجتياز من خلال خطوات التقدم للأمام ومقارنات المواضع. عبر عامل التزايد البادئ operator++، يتم تقديم المكرر إلى عنصر البيانات التالي ([SWS_DM_02263]). ويتم تحديد الصلاحية والوصول إلى نهاية التسلسل عبر عاملي المساواة وعدم المساواة operator== ([SWS_DM_02261]) وoperator!= ([SWS_DM_02262]) مقارنة بمكرر خفير (Sentinel) أو مكرر نهاية.

فيما يتعلق بالتزامن، تم تحديد جميع دوال الأعضاء في الفئة صراحة بأنها آمنة بالنسبة للخيوط ([SWS_DM_02259]، [SWS_DM_02260]، [SWS_DM_02261]، [SWS_DM_02262]، [SWS_DM_02263]). يتيح ذلك عمليات وصول متوازية بالقراءة إلى حالات مكرر منفصلة في بيئات متعددة الخيوط.

مسار الاستخدام

يتبع المسار النموذجي عند تقييم محتويات سجل SOVD نمط مكرر التقدم للأمام الكلاسيكي في C++‎:

  • التحقق من شرط الإنهاء: قبل كل وصول، يقارن التطبيق الموضع الحالي بمكرر النهاية بواسطة operator!= ([SWS_DM_02262]).
  • الوصول إلى العنصر: إذا كان المكرر يشير إلى عنصر صالح، يصل التطبيق إما عبر مرجع بواسطة operator* إلى DiagnosticSovdContentElementDataWithKey ([SWS_DM_02259]) أو يستخدم عامل الوصول إلى العنصر operator-> ([SWS_DM_02260]) لمخاطبة طرق أو حقول عنصر البيانات مباشرة.
  • التقديم: بواسطة operator++، تتم زيادة المكرر إلى الموضع التالي ([SWS_DM_02263]).
تسلسل استخدام المكرر مع عناصر بيانات SOVD-RecordالتطبيقIterator: DiagnosticSovdRecordContentElementDataIteratorElement: DiagnosticSovdContentElementDataWithKeyloopSolange it != endoperator!=(end)truealtDirektzugriff per Zeigeroperator->()DiagnosticSovdContentElementDataWithKey*Referenzzugriffoperator*()DiagnosticSovdContentElementDataWithKey&Nutzdaten lesen / auswertenoperator++()مرجع إلى *this

مخطط تسلسل: المسار النموذجي لاجتياز عناصر بيانات سجل SOVD. المصادر: [SWS_DM_02259]، [SWS_DM_02260]، [SWS_DM_02262]، [SWS_DM_02263].

سيناريوهات الأخطاء

جميع العمليات المحددة للمكرر مصرّح بها بأنها آمنة من الاستثناءات (exception safe) وبأنها noexcept ([SWS_DM_02259]، [SWS_DM_02260]، [SWS_DM_02261]، [SWS_DM_02262]، [SWS_DM_02263]). وهذا يعني أنه لا يتم طرح أي استثناءات أثناء التشغيل العادي ولا تنشأ رموز أخطاء للتقييم.

تفسير: كشرط مسبق أساسي لاستدعاءات operator* وoperator-> وoperator++، يجب أن يشير المكرر إلى موضع صالح وألا يتطابق مع مكرر النهاية. سؤال (مفتوح) من المرجح أن يؤدي تقديم مكرر غير صالح أو إلغاء مرجعيته في سياق معيار C++‎ إلى سلوك غير محدد. لذلك يجب على التطبيقات التحقق بدقة من الوصول إلى النهاية بواسطة operator!= أو operator== ([SWS_DM_02261]، [SWS_DM_02262]).

يستند دليل الفئة هذا إلى مواصفة AUTOSAR Adaptive Platform R25-11 (الوحدة diag) ويلخص المتطلبات الخاصة بـ ara::diag::DiagnosticSovdRecordContentElementDataIterator.

خريطة الأعضاء

الدوال الأعضاء

1
DiagnosticSovdRecord

المعاملات

2
operator*operator==

مخطط الفئة

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

G nara__diag__DiagnosticSovdRecordContentElementDataIterator471 DiagnosticSovdRecordContentElementDataIterator + DiagnosticSovdRecord() + operator*() + operator==()

عرض التفاصيل

اختر عنصرًا من المخطط.

الدوال الأعضاء

DiagnosticSovdRecord دالة 3

Dereference operator.

التحميلات الزائدة DiagnosticSovdRecord 3
auto operator-> () noexcept -> DiagnosticSovdContentElementDataWithKey *; SWS_DM_02260
auto operator!= (DiagnosticSovdRecordContentElementDataIterator const &other) noexcept -> bool; SWS_DM_02262
auto operator++ () noexcept -> DiagnosticSovdRecordContentElementData Iterator &; SWS_DM_02263

المعاملات

operator* دالة

Dereference operator.

auto operator* () noexcept -> DiagnosticSovdContentElementDataWithKey &;
operator== دالة

Equal operator.

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

توثيق الدوال

دالة DiagnosticSovdRecord [SWS_DM_02260] Upstream: RS_Diag_04260

auto operator-> () noexcept -> DiagnosticSovdContentElementDataWithKey *;

Dereference operator.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 76d5b17fb7d6 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام والدلالات

يُستخدم عامل إلغاء المرجعية operator-> للفئة ara::diag::DiagnosticSovdRecordContentElementDataIterator للوصول المتزامن إلى الأعضاء لعنصر بيانات معنون ([SWS_DM_02260]). يعيد الاستدعاء مؤشرًا من النوع DiagnosticSovdContentElementDataWithKey* إلى العنصر الحالي ([SWS_DM_02260]). الواجهة معرّفة في الترويسة ara/diag/diagnostic_sovd_content_element_data.h ([SWS_DM_02260]).

التزامن والشروط الحدية

تعتبر الدالة noexcept وتضمن أمان الاستثناءات (exception safe) وهي محددة بأنها آمنة تفرعيًا (thread-safe) ([SWS_DM_02260]). لا يوجد رمز خطأ محدد لدالة العضو هذه. تفسير: قبل الاستدعاء، يجب أن يشير المكرر إلى عنصر بيانات صالح وألا يتوافق مع نهاية النطاق، لأن إلغاء مرجعية مكرر غير صالح من المرجح أن يؤدي إلى سلوك غير محدد. سؤال Q-735b580a0b2c8330 (مفتوح)

تفاعل

يُستخدم المكرر في إطار معالجة محتويات السجلات جنبًا إلى جنب مع دوال أخرى:

  • يمكن الحصول عليه عبر عمليات البحث مثل Find على DiagnosticSovdRecordContentElementDataView ([SWS_DM_02285]).
  • يتم التحكم في الحلقات عادة عبر عامل الزيادة البادئة operator++ ([SWS_DM_02263]) وعامل عدم المساواة operator!= ([SWS_DM_02262]) بالمقارنة مع مكرر النهاية من RecordEnd ([SWS_DM_02360]).
  • للسياقات المحمية من الكتابة، يتوفر DiagnosticSovdRecordContentElementDataConstIterator، والذي يعيد operator-> الخاص به مؤشرًا إلى const DiagnosticSovdContentElementDataWithKey ([SWS_DM_02266]).

تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند إلى مواصفات AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

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

Rückgabewert

TypBeschreibung
DiagnosticSovdContent Return a pointer to the DiagnosticSovdAbstractContentDataWith ElementDataWithKey * Key

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

Record
AUTOSAR/AP/record/SWS_DM_02260
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02260@rel:R25-11#227378f6
Content hash
227378f6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02260
Status: valid/unmigrated Version: rel:R25-11#c2b0a45d Versionshistorie & Revisions (1 transition)
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_02260@rel:R25-11#c2b0a45d
Point-in-Time History:
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

دالة DiagnosticSovdRecord [SWS_DM_02262] Upstream: RS_Diag_04260

auto operator!= (DiagnosticSovdRecordContentElementDataIterator const &other) noexcept -> bool;

Not equal operator.

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

Parameter (in)

ParameterBeschreibung
otherThe other iterator to test equality with

Rückgabewert

TypBeschreibung
boolTrue if operator are equals, false otherwise

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

Record
AUTOSAR/AP/record/SWS_DM_02262
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02262@rel:R25-11#f196ec94
Content hash
f196ec94
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02262
Status: valid/unmigrated Version: rel:R25-11#9e75e955 Versionshistorie & Revisions (1 transition)
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_02262@rel:R25-11#9e75e955
Point-in-Time History:
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

دالة DiagnosticSovdRecord [SWS_DM_02263] Upstream: RS_Diag_04260

auto operator++ () noexcept -> DiagnosticSovdRecordContentElementData Iterator &;

Increment operator.

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

Rückgabewert

TypBeschreibung
DiagnosticSovdRecordContentElementDataIteratorReference to the incremented iterator

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

Record
AUTOSAR/AP/record/SWS_DM_02263
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02263@rel:R25-11#619c0d3f
Content hash
619c0d3f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02263
Status: valid/unmigrated Version: rel:R25-11#eceb251b Versionshistorie & Revisions (1 transition)
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_02263@rel:R25-11#eceb251b
Point-in-Time History:
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

دالة operator* [SWS_DM_02259] Upstream: RS_Diag_04260

auto operator* () noexcept -> DiagnosticSovdContentElementDataWithKey &;

Dereference operator.

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

Rückgabewert

TypBeschreibung
DiagnosticSovdContentElementDataWithKeyReturn a view on the content element

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

Record
AUTOSAR/AP/record/SWS_DM_02259
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02259@rel:R25-11#430150f2
Content hash
430150f2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02259
Status: valid/unmigrated Version: rel:R25-11#0d7599c2 Versionshistorie & Revisions (1 transition)
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_02259@rel:R25-11#0d7599c2
Point-in-Time History:
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

دالة operator== [SWS_DM_02261] Upstream: RS_Diag_04260

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

Equal operator.

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

Parameter (in)

ParameterBeschreibung
otherThe other iterator to test equality with

Rückgabewert

TypBeschreibung
boolTrue if operator are equals, false otherwise

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

Record
AUTOSAR/AP/record/SWS_DM_02261
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02261@rel:R25-11#b30aa376
Content hash
b30aa376
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02261
Status: valid/unmigrated Version: rel:R25-11#904f6ffe Versionshistorie & Revisions (1 transition)
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_02261@rel:R25-11#904f6ffe
Point-in-Time History:
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