يوفر وصولاً للقراءة فقط وآمنًا خيطيًا إلى عناصر السجل (Record) لبيانات SOVD التشخيصية.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5db4cee55bd3المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يوفر وصولاً للقراءة فقط وآمنًا خيطيًا إلى عناصر السجل (Record) لبيانات SOVD التشخيصية.
يوفر الصنف عرضًا ثابتًا لعناصر محتوى سجل SOVD المنظمة لإجراء تقييم فعال وللقراءة فقط في تطبيقات التشخيص ([SWS_DM_02295]). ويمكن للمستخدمين التحقق من حالة الخطأ عبر كائنات النتائج، أو عنونة عناصر سجل البيانات بشكل هادف عبر المفتاح، أو اجتياز المحتوى بالكامل تسلسليًا باستخدام مكررات ثابتة ([SWS_DM_02300]). وجميع الواجهات آمنة خيطيًا بالكامل ومصرح عنها بأنها آمنة من الاستثناءات، ولكنها تفترض مسبقًا أن عنصر المحتوى المشار إليه يطابق نوع السجل المتوقع.
السياق
يحدد الصنف ara::diag::DiagnosticSovdRecordContentElementDataConstView عرضًا ثابتًا (Const View) لعناصر محتوى SOVD التشخيصية من نوع مجموعة البيانات Record ([SWS_DM_02295]، AUTOSAR_AP_SWS_Diagnostics §8.60.9 «Class: DiagnosticSovdRecordContentElementDataConstView»). وتتوفر الواجهة عبر ملف الترويسة #include "ara/diag/diagnostic_sovd_content_element_data.h" ([SWS_DM_02298]). وهي تتيح لتطبيقات التشخيص القراءة الهادفة والمنظمة لحقول البيانات المقسمة هرميًا لعنصر محتوى SOVD، دون الحاجة إلى إنشاء نسخ من الحمولة النافعة أو تنفيذ عمليات تعديل.
تشمل أطراف التفاعل الأساسية مكون التشخيص المستدعي، والكائن الأساسي من النوع DiagnosticSovdContentElementData، بالإضافة إلى العناصر الفردية المعنونة عبره، والتي يتم توفيرها كغلاف مرجعي ثابت std::reference_wrapper<DiagnosticSovdContentElementData const> أو عبر مكررات ثابتة ([SWS_DM_02300]، [SWS_DM_02301]).
دورة الحياة
كنوع عرض، يُرجح ألا يمتلك ara::diag::DiagnosticSovdRecordContentElementDataConstView ملكية خاصة للحمولة النافعة الأساسية؛ ويُفترض أن تكون صلاحية العرض مرتبطة بعمر كائن DiagnosticSovdContentElementData المشار إليه. سؤال Q-4aca4f6f723cd3f5 (مفتوح) يؤدي تدمير مثيل العرض (View) إلى تحرير واصف العرض فقط، مع ترك بنية البيانات الأساسية دون تغيير.
فيما يتعلق بالتزامن، تم تحديد جميع دوال الأعضاء في الصنف صراحةً على أنها آمنة خيطيًا وآمنة من الاستثناءات (noexcept) ([SWS_DM_02296]، [SWS_DM_02298]). وبالتالي، يمكن لعدة خيوط الوصول إلى الواجهة للقراءة بالتوازي ودون مزامنة، بشرط عدم تعديل بنية البيانات المشار إليها بالتزامن أثناء الوصول.
مسار الاستخدام
ينقسم المسار النموذجي لتقييم عنصر السجل إلى التحقق من الخطأ، والتحقق من الأبعاد، والوصول إلى العناصر:
التحقق من حالة الخطأ: قبل المعالجة، يتم التحقق عبر HasError() مما إذا كان المحتوى خاليًا من الأخطاء ([SWS_DM_02296]).
الوصول الهادف إلى العناصر: قبل الوصول إلى حقل مسمى، يمكن التحقق من وجود مفتاح باستخدام HasContentElement() ([SWS_DM_02305]). ويتم الوصول العشوائي لاحقًا عبر operator[] مع تمرير ara::core::StringView، والذي يُرجع مرجعًا إلى العنصر الفرعي ([SWS_DM_02300]). وبدلاً من ذلك، يُرجع Find() مكررًا إلى العنصر الذي تم العثور عليه ([SWS_DM_02306]).
يستخدم الصنف نوع الإرجاع ara::core::Result لمعالجة الأخطاء بدلاً من استثناءات C++:
حالة خطأ داخلية: إذا كان عنصر محتوى SOVD الأساسي يحتوي على خطأ، يُرجع HasError() كائن ara::core::Result<void> يحتوي على رمز الخطأ ara::diag::DiagSovdErrc ([SWS_DM_02296]).
مفتاح مفقود أو تعارض في النوع: عند الوصول عبر operator[] أو الفحص باستخدام HasContentElement()، تُرجع قيمة الإرجاع Result خطأ إذا لم يكن DiagnosticSovdContentElementData من النوع RecordContentElementData أو ContentData أو إذا كان المفتاح المحدد غير موجود ([SWS_DM_02300]، [SWS_DM_02305]).
Returns the begin operator of a RecordContentElementData. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
auto Begin () noexcept -> DiagnosticSovdRecordContentElementDataConst Iterator;
Returns the begin operator of a RecordContentElementData. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
auto CBegin () noexcept -> DiagnosticSovdRecordContentElementDataConst Iterator;
Returns if the RecordContentElementData contains an element with the specified key. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
Returns the count of elements in the RecordContentElementData. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
auto Begin () noexcept -> DiagnosticSovdRecordContentElementDataConst Iterator;
Returns the begin operator of a RecordContentElementData. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
auto CBegin () noexcept -> DiagnosticSovdRecordContentElementDataConst Iterator;
Returns the begin operator of a RecordContentElementData. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
Returns if the RecordContentElementData contains an element with the specified key. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
boolean indicating if the elements is found or an error if Diagnostic SovdContentElementData is not of type RecordContentElement Data or ContentData OR the key is not found
Request a governed re-review of this record. The record is not changed immediately.
Returns the count of elements in the RecordContentElementData. This DiagnosticSovdContentElementData shall be of type RecordContentElementData or ContentData
reference to the content element or an error if DiagnosticSovdContentElementData is not of type RecordContentElementData or ContentData OR the key is not found
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني