DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DiagnosticSovdRecordContentElementDataConstIterator

[SWS_DM_02264] Upstream: RS_Diag_04260

class DiagnosticSovdRecordContentElementDataConstIterator {...};

Const 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 · درجة الحرارة: غير قابل للتحكم · الموجّه: 3164759db88e المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتيح الوصول التسلسلي الآمن للخيوط والمخصص للقراءة فقط إلى عناصر محتوى سجل SOVD التشخيصية.

تعمل الفئة ara::diag::DiagnosticSovdRecordContentElementDataConstIterator وفقاً لـ [SWS_DM_02264] كمكرر أمامي ثابت للاجتياز المخصص للقراءة فقط لعناصر محتوى سجل SOVD. وهي توفر عوامل لاختبارات التساوي، والتقديم، بالإضافة إلى فك الإسناد إلى DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265]). ونظراً لأن جميع العوامل آمنة من الاستثناءات وآمنة للخيوط وفقاً لـ noexcept، تقع المسؤولية على عاتق المتصل لعدم فك إسناد أي مكررات غير صالحة.

السياق

تُعرف الفئة ara::diag::DiagnosticSovdRecordContentElementDataConstIterator بواسطة [SWS_DM_02264] في AUTOSAR_AP_SWS_Diagnostics §8.60.8. وتُستخدم كمكرر أمامي أو إدخال ثابت لعناصر من النوع DiagnosticSovdRecordContentElementData، كما هو موضح في AUTOSAR_AP_SWS_Diagnostics §8.60.8. ويعمل كشركاء تفاعل تطبيقاتُ التشخيص الخاصة بالوحدة diag، التي تجتاز مجموعات عناصر بيانات SOVD («Service-Oriented Vehicle Diagnostics») للقراءة فقط، وكذلك العناصر المشار إليها من النوع DiagnosticSovdContentElementDataWithKey، والتي يمنح المكرر الوصول إليها أثناء فك الإسناد ([SWS_DM_02265]، [SWS_DM_02266]).

دورة الحياة

تبدأ دورة حياة المكرر عادةً باسترجاع نسخة مكرر عبر واجهة هيكل بيانات أساسي لعناصر سجل SOVD (تفسير: تحتوي الحاويات على الأرجح على طرائق مثل cbegin() وcend()، توفر نسخ مكرر صالحة). سؤال Q-9c5e4d32ae82e7cf (مفتوح) ونظراً لأنه مجرد مغلّف قيمة أو مؤشر دون إدارة ديناميكية للموارد، فإن المكرر لا يمتلك آلية تدمير صريحة ويمكن نسخه أو نقله. تضمن المواصفة أمان الاستثناءات (exception safe) وأماناً كاملاً للخيوط (thread-safe) لجميع عمليات المكرر ([SWS_DM_02265]، [SWS_DM_02266]، [SWS_DM_02267]، [SWS_DM_02268]، [SWS_DM_02269]). وفيما يتعلق بالتزامن، يعني هذا أنه يمكن تنفيذ عمليات الوصول المتوازية للقراءة على المكرر نفسه أو على نسخ مستقلة دون تدابير مزامنة إضافية.

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

يتضمن مسار الاستخدام النموذجي اجتيازًا تكراريًا لمجموعة من بيانات عناصر SOVD ضمن روتينات المعالجة التشخيصية. يتحقق المتصل أولاً عبر عامل عدم المساواة operator!= ([SWS_DM_02268]) أو عامل المساواة operator== ([SWS_DM_02267]) مما إذا كان قد تم الوصول إلى نهاية التسلسل. وطالما كان المكرر صالحًا، يصل التطبيق بالقراءة إلى العنصر المشار إليه: يُرجع عامل إلغاء المرجعية operator* مرجعًا ثابتًا إلى DiagnosticSovdContentElementDataWithKey ([SWS_DM_02265])، بينما يُرجع عامل السهم operator-> مؤشرًا إلى الكائن الثابت ([SWS_DM_02266]). بعد ذلك، يقدّم عامل التزايد البادئ operator++ المكرر بمقدار موضع واحد ويُرجع مرجعًا إلى المكرر المتزايد ([SWS_DM_02269]).

اجتياز باستخدام DiagnosticSovdRecordContentElementDataConstIteratorالتطبيقIterator: DiagnosticSovdRecordContentElementDataConstIteratorElement: DiagnosticSovdContentElementDataWithKeyUse Case: فحص نهاية التسلسلoperator!=(endIterator)bool (true = لا تزال توجد عناصر)loopsolange Iterator != endIteratorUse Case: وصول للقراءة فقط إلى البياناتoperator*() أو operator->()DiagnosticSovdContentElementDataWithKey const& / const*Datenfelder auslesenUse Case: Weiterschaltenoperator++()مرجع إلى مكرر تمت زيادتهoperator!=(endIterator)bool

مخطط تسلسل: المسار النموذجي للاجتياز التسلسلي لعناصر محتوى سجل SOVD بواسطة المكرر الثابت (Const-Iterator). المصادر: [SWS_DM_02265]، [SWS_DM_02266]، [SWS_DM_02267]، [SWS_DM_02268]، [SWS_DM_02269]

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

جميع دوال الأعضاء في ara::diag::DiagnosticSovdRecordContentElementDataConstIterator مصرّح بها باستخدام المحدد noexcept ([SWS_DM_02265]، [SWS_DM_02266]، [SWS_DM_02267]، [SWS_DM_02268]، [SWS_DM_02269]). ولا يطرح أيّ من operator* أو operator-> أو عوامل المقارنة استثناءات C++‎ أو يُرجع هياكل أخطاء ara::core::Result. والشرط المسبق للاستدعاء الخالي من الأخطاء لكل من operator* وoperator-> وoperator++ هو صلاحية المكرر: من المرجح أن يؤدي إلغاء مرجعية مكرر النهاية (Past-the-End) أو تمريره إلى سلوك غير محدد (تفسير: لا يتضمن تعريف الواجهة أي عمليات تحقق في وقت التشغيل لعمليات إلغاء المرجعية غير الصالحة). سؤال Q-e26c9aa50597bf18 (مفتوح) لذلك يجب على المستخدمين التأكد دائمًا من إجراء مقارنة إنهاء مع مكرر النهاية قبل الوصول.

يستند هذا الدليل حصريًا إلى متطلبات المواصفة من AUTOSAR AP R25-11.

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

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

1
DiagnosticSovdRecord

المعاملات

2
operator*operator==

مخطط الفئة

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

G nara__diag__DiagnosticSovdRecordContentElementDataConstIterator644 DiagnosticSovdRecordContentElementDataConstIterator + DiagnosticSovdRecord() + operator*() + operator==()

عرض التفاصيل

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

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

DiagnosticSovdRecord دالة 3

Dereference operator.

التحميلات الزائدة DiagnosticSovdRecord 3
auto operator-> () noexcept -> DiagnosticSovdContentElementDataWithKey const *; SWS_DM_02266
auto operator!= (DiagnosticSovdRecordContentElementDataConstIterator const &other) noexcept -> bool; SWS_DM_02268
auto operator++ () noexcept -> DiagnosticSovdRecordContentElementData ConstIterator &; SWS_DM_02269

المعاملات

operator* دالة

Dereference operator.

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

Equal operator.

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

توثيق الدوال

دالة DiagnosticSovdRecord [SWS_DM_02266] Upstream: RS_Diag_04260

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

Dereference operator.

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

الاستخدام

تُستخدم دالة العضو operator-> للفئة ara::diag::DiagnosticSovdRecordContentElementDataConstIterator ([SWS_DM_02264]) كعامل إلغاء المرجعية للوصول المحمي من الكتابة إلى عناصر بيانات SOVD ([SWS_DM_02266]، AUTOSAR_AP_SWS_Diagnostics §8.60.8.1.1.4 «operator->»). يتم الاستدعاء بدون معلمات وبشكل متزامن عبر الترويسة ara/diag/diagnostic_sovd_content_element_data.h. كقيمة إرجاع، تعيد الدالة مؤشرًا ثابتًا من النوع DiagnosticSovdContentElementDataWithKey const * إلى بيانات العنصر المشار إليها مع المفتاح ([SWS_DM_02266]).

معالجة الأخطاء

تم الإعلان عن الدالة بـ noexcept ومصنفة في المواصفات على أنها آمنة من حيث الاستثناءات (exception safe) ([SWS_DM_02266]). لا يتم إطلاق استثناءات C++ ولا يتم الإبلاغ عن رموز أخطاء عبر ara::core::Result. تفسير: يُفترض أن إلغاء مرجعية مكرر غير مهيأ، أو غير صالح، أو موجود بالفعل في نهاية النطاق يؤدي إلى سلوك غير محدد، ولهذا يجب على المتصل التأكد من الصلاحية قبل استدعاء العامل. سؤال Q-4c149c4fb2d68f33 (مفتوح)

التزامن والقيود

وفقًا للمواصفة، يتم تعريف الوصول على أنه آمن تفرعيًا (thread-safe) ([SWS_DM_02266]). ونظرًا لأن العملية تمنح حق الوصول للقراءة فقط إلى العنصر الأساسي، فيمكن لعدة سلاسل عمليات إلغاء مرجعية نفس البيانات بشكل متزامن عبر مكررات ثابتة.

تفاعل

تعمل الدالة بتوافق وثيق مع واجهات برمجية أخرى للمكرر وهياكل بيانات التشخيص:

  • التنقل والمقارنة: عند التكرار عبر محتويات السجل، يتم عادة تقديم المكرر باستخدام operator++ ([SWS_DM_02269]) ومقارنته بمكررات النهاية عبر operator!= ([SWS_DM_02268]).
  • حدود النطاق: يمكن تحديد نهاية النطاق الثابتة المقترنة عبر RecordCEnd ([SWS_DM_02362]) للفئة DiagnosticSovdContentElementData.
  • بديل غير ثابت: لعمليات الوصول المعدلة، يتوفر النظير operator-> للفئة DiagnosticSovdRecordContentElementDataIterator ([SWS_DM_02260])، والذي يمكن الحصول عليه عبر دوال مثل Find ([SWS_DM_02285]) أو RecordEnd ([SWS_DM_02360]).

تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.

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

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

Rückgabewert

TypBeschreibung
DiagnosticSovdContentElementDataWithKeyReturn a pointer to the DiagnosticSovdAbstractContentDataWith Key const *

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

Record
AUTOSAR/AP/record/SWS_DM_02266
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02266@rel:R25-11#44598c66
Content hash
44598c66
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02266
Status: valid/unmigrated Version: rel:R25-11#4fa0d923 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_02266@rel:R25-11#4fa0d923
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_02268] Upstream: RS_Diag_04260

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

Not equal operator.

Header-Datei#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scopeclass ara::diag::DiagnosticSovdRecordContentElementDataConstIterator
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_02268
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02268@rel:R25-11#6c011b2a
Content hash
6c011b2a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02268
Status: valid/unmigrated Version: rel:R25-11#069b7496 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_02268@rel:R25-11#069b7496
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_02269] Upstream: RS_Diag_04260

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

Increment operator.

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

Rückgabewert

TypBeschreibung
DiagnosticSovdRecordContentElementDataConstIteratorReference to the incremented iterator

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

Record
AUTOSAR/AP/record/SWS_DM_02269
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02269@rel:R25-11#47e33576
Content hash
47e33576
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02269
Status: valid/unmigrated Version: rel:R25-11#56e88cdf 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_02269@rel:R25-11#56e88cdf
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_02265] Upstream: RS_Diag_04260

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

Dereference operator.

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

Rückgabewert

TypBeschreibung
DiagnosticSovdContentElementDataWithKeyconstReturn 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_02265
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02265@rel:R25-11#858bbe43
Content hash
858bbe43
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02265
Status: valid/unmigrated Version: rel:R25-11#3f32ca4d 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_02265@rel:R25-11#3f32ca4d
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_02267] Upstream: RS_Diag_04260

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

Equal operator.

Header-Datei#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scopeclass ara::diag::DiagnosticSovdRecordContentElementDataConstIterator
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_02267
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_02267@rel:R25-11#b3e740bd
Content hash
b3e740bd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_02267
Status: valid/unmigrated Version: rel:R25-11#d38e7bd6 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_02267@rel:R25-11#d38e7bd6
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