فئة ara::diag::DiagnosticSovdArrayContentElementDataConstIterator

توفر الفئة ara::diag::DiagnosticSovdArrayContentElementDataConstIterator مكرراً أمامياً للقراءة فقط لعناصر المصفوفة في سياق تشخيص SOVD ([SWS_DM_02221]). تستخدمه التطبيقات لاجتياز هياكل البيانات من النوع DiagnosticSovdContentElementData تدريجياً عبر عوامل المقارنة وفك الإسناد والزيادة ([SWS_DM_02222]). ونظراً لأن جميع العمليات محددة على أنها noexcept، فإن التحقق من حدود التكرار يقع على عاتق المتصل، وذلك لتجنب السلوك غير المحدد عند المواضع غير الصالحة.

المزيد ›

السياق

الفئة ara::diag::DiagnosticSovdArrayContentElementDataConstIterator هي جزء من وحدة التشخيص (diag) في AUTOSAR Adaptive Platform ([SWS_DM_02221]، AUTOSAR_AP_SWS_Diagnostics §8.60.2 «Class: DiagnosticSovdArrayContentElementDataConstIterator»). وهي تلبي المتطلبات القياسية لـ Service-Oriented Vehicle Diagnostics (SOVD) وتوفر مكرراً أمامياً ثابتاً لحقول البيانات التسلسلية. مسؤوليتها المركزية هي تغليف الوصول للقراءة فقط إلى العناصر الفردية من النوع DiagnosticSovdContentElementData ([SWS_DM_02222]، [SWS_DM_02223]). وتظهر تطبيقات التشخيص كشركاء تفاعل، حيث تقوم بتقييم محتويات المصفوفة المتوافقة مع SOVD عبر ملف الترويسة ara/diag/diagnostic_sovd_content_element_data.h دون القدرة على تعديل هياكل الذاكرة الأساسية.

دورة الحياة

لا تسرد مواصفات الفئة [SWS_DM_02221] أي دوال بناء عامة. وبالتالي، فمن المحتمل ألا يتم إنشاء نسخة المكرر بواسطة برمجية التطبيق نفسها، بل يتم توفيرها من خلال طرائق الحاوية لكائن البيانات ذي المستوى الأعلى. سؤال Q-a2a94d90c92beb71 (مفتوح) ويمثل المكرر بعد إنشائه موضعاً ثابتاً داخل تسلسل المصفوفة.

يتم الانتقال إلى الموضع التالي في كل مرة عبر عامل الزيادة البادئة operator++، الذي يرجع مرجعاً لكائن المكرر المزاح نفسه ([SWS_DM_02226]). وفيما يتعلق بالتزامن، فإن جميع الدوال الأعضاء للفئة محددة صراحةً بأنها آمنة للخيوط (thread-safe) ([SWS_DM_02222] إلى [SWS_DM_02226]). وبالتالي يمكن لعدة خيوط قراءة الموضع نفسه أو مواضع مختلفة بشكل متزامن. وإذا تم دفع حالة المكرر تعديلياً بواسطة operator++، فإن ذلك يتطلب مزامنة خارجية في حالة الاستخدام المشترك. ويُرجح أن تكون فترة بقاء البيانات المفيدة المشار إليها مقيدة بشكل صارم بفترة بقاء حاوية البيانات المزودة. سؤال Q-743ef89528de7a75 (مفتوح)

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

يطابق مسار الاستخدام النموذجي أسلوب C++ التقليدي للمكررات الثابتة عبر مجموعة. وفي بداية التكرار، يتحقق المتصل من صلاحية الموضع الحالي بواسطة عامل عدم التساوي operator!= ([SWS_DM_02225]) أو عامل التساوي operator== ([SWS_DM_02224]) مقارنةً بمكرر النهاية. وإذا كان المكرر يقع ضمن النطاق الصالح، يصل التطبيق إلى العنصر للقراءة:

• عبر عامل فك الإسناد operator* ([SWS_DM_02222])، يتم إرجاع مرجع ثابت DiagnosticSovdContentElementData const&.
• عبر عامل السهم operator-> ([SWS_DM_02223])، يتم تقديم مؤشر ثابت DiagnosticSovdContentElementData const*، مما يسمح بالوصول المباشر إلى طرائق العناصر.

بعد ذلك، يتقدم المتصل بالمكرر موضعاً واحداً باستخدام operator++ ([SWS_DM_02226]) ويكرر التحقق من الموضع حتى الوصول إلى الحالة النهائية.

مخطط تسلسلي: المسار النموذجي للتكرار المتدرج عبر عناصر مصفوفة SOVD. المصادر: [SWS_DM_02222]، [SWS_DM_02225]، [SWS_DM_02226]

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

لا تحدد الواجهة رموز خطأ خاصة أو حالات إرجاع في صورة ara::core::Result. جميع العمليات محددة على أنها آمنة من الاستثناءات (exception safe) ومزودة بالمحدد noexcept ([SWS_DM_02222] إلى [SWS_DM_02226]). ولا يتم إطلاق أي استثناءات C++ أثناء التشغيل.

يعد كوْن المكرر قابلاً لفك الإسناد شرطاً مسبقاً أساسياً لاستدعاءات operator* وoperator->. ومن المحتمل أن يؤدي فك إسناد مكرر غير صالح أو مكرر النهاية إلى سلوك غير محدد نظراً لغياب آليات معالجة الأخطاء. سؤال Q-9144a319e654f27a (مفتوح) كما يقع على عاتق المتصل التأكد من أن المكررين المقارنين ينتميان إلى التسلسل نفسه.