توفر وصولًا مرمز النوع للقراءة والكتابة إلى عناصر مصفوفة لبيانات تشخيص SOVD عبر الفهارس والمكررات.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d333ea0efb38المصدرأسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
توفر وصولًا مرمز النوع للقراءة والكتابة إلى عناصر مصفوفة لبيانات تشخيص SOVD عبر الفهارس والمكررات.
توفر الفئة واجهة منظمة للوصول العشوائي والقائم على المكررات إلى عناصر البيانات التشخيصية القائمة على المصفوفات لـ Adaptive Platform ([SWS_DM_02227]). وتتيح للتطبيقات الإلحاق الديناميكي لقيم البيانات الأولية وعناصر المحتوى المعقدة، بالإضافة إلى الحجز المسبق لسعات التخزين. وفي حالات أنواع البيانات غير المتوافقة، أو الوصول غير الصالح عبر الفهرس، أو حالات الأخطاء المضبوطة صراحةً، يتم تمرير رموز الأخطاء عبر أنواع النتائج إلى المستدعي ([SWS_DM_02228]). ووفقًا للمعيار، تم تنفيذ جميع العمليات المحددة لتكون آمنة تمامًا من حيث الاستثناءات وخيوط المعالجة.
السياق
تُعرَّف الفئة ara::diag::DiagnosticSovdArrayContentElementDataView في AUTOSAR_AP_SWS_Diagnostics §8.60.5 «Class: DiagnosticSovdArrayContentElementDataView» تحت [SWS_DM_02227]. وتُستخدم في وحدة تشخيص AUTOSAR Adaptive كعرض محدد النوع لعنصر محتوى تشخيصي (DiagnosticSovdContentElementData) مع النوع الأساسي ArrayContentElementData. ويتم الإعلان عنها عبر ملف الترويسة ara/diag/diagnostic_sovd_content_element_data.h.
تكمن مسؤوليتها الأساسية في التغليف المنظم لعمليات المصفوفات الخاصة بـ Service-Oriented Vehicle Diagnostics (SOVD). ويعمل كأطراف تفاعل كل من تطبيقات التشخيص المستدعية، التي تعالج هياكل بيانات SOVD أو توفرها، بالإضافة إلى حاويات البيانات العامة الأساسية. وتتم معالجة الوصول إلى عناصر الحقول الفردية إما عبر مكررات مخصصة أو عبر معاملات الفهرسة محددة النوع.
دورة الحياة
باعتباره كائن عرض (View)، يُفترض ألا يمتلك المثيل الملكية الحصرية للبيانات المفيدة الفعلية، بل يرتبط بذاكرة DiagnosticSovdContentElementData موجود. سؤال Q-04a43d21a981ea92 (مفتوح) وتخضع دورة حياة البيانات للمراحل التالية:
حجز الذاكرة والسعة: قبل إدراج كميات بيانات أكبر، يمكن تحديد سعة التخزين الداخلية بصورة استباقية عبر Reserve ([SWS_DM_02240]). ويمكن الاستعلام عن السعة الحالية بواسطة Capacity ([SWS_DM_02231]).
التعبئة: تُلحق العناصر الجديدة تسلسليًا عبر تحميلا زائدة (overloads) للتابع PushBack. وتُدعم أنواع البيانات الأولية مثل std::int64_t ([SWS_DM_02241])، وstd::uint64_t ([SWS_DM_02242])، وdouble ([SWS_DM_02243])، وbool ([SWS_DM_02244])، وara::core::StringView ([SWS_DM_02245])، بالإضافة إلى كائنات DiagnosticSovdContentElementData المتداخلة ([SWS_DM_02246]).
الفحص والتفريغ: يمكن الاستعلام عن حالة الإشغال في أي وقت عبر Size ([SWS_DM_02230]) وEmpty ([SWS_DM_02232]). ويمكن إزالة عناصر فردية بواسطة مكرر عبر Erase ([SWS_DM_02247])، بينما يعيد Clear ([SWS_DM_02233]) تعيين المصفوفة بأكملها.
فيما يتعلق بالتزامن ومعالجة الاستثناءات، فإن جميع دوال الأعضاء في الفئة مصممة، وفقًا للمواصفة، لتكون آمنة من الاستثناءات (مُعلنة بـ noexcept) وآمنة خيطيًا (”thread-safe“).
مسار الاستخدام
يتضمن مسار الاستخدام النموذجي حجز السعة التحضيري، وتعبئة البيانات خطوة بخطوة، وقراءة العناصر، بالإضافة إلى التحقق النهائي من حالات الخطأ:
حجز السعة: يستدعي التطبيق Reserve لتقليل عمليات إعادة التخصيص الديناميكية أثناء عمليات الكتابة اللاحقة ([SWS_DM_02240]).
إدراج العناصر: تُلحق سجلات البيانات باستخدام PushBack ([SWS_DM_02241]).
تستخدم الدوال المعرضة للأخطاء ara::core::Result للإبلاغ عن الشروط المسبقة غير الصحيحة أو حالات إحباط التنفيذ بدلاً من استثناءات C++:
عدم تطابق النوع: تشترط عمليات مثل PushBack ([SWS_DM_02241]) أو operator[] ([SWS_DM_02234]) أن يكون العنصر المغلف من النوع ArrayContentElementData فعليًا. وإلا، فإنها تعيد خطأً مطابقًا في الكائن Result. وفي حالة PushBack، يجب أن يتطابق النوع المُدرج أيضًا مع نوع البيانات المحدد في منشئ عنصر المصفوفة.
فشل الحذف: يعيد استدعاء Erase ([SWS_DM_02247]) خطأً في Result إذا لم يكن الهدف من النوع ArrayContentElementData أو إذا تعذرت إزالة العنصر عبر المكرر المحدد.
حالات الخطأ الصريحة: يمكن عبر SetError ([SWS_DM_02229]) تعيين ara::core::ErrorCode لمحتوى المصفوفة. وإذا تم وسم المحتوى على أنه خاطئ بهذه الطريقة، فإن الاستعلام HasError ([SWS_DM_02228]) يعيد رمز الخطأ كـ ara::diag::DiagSovdErrc.
يعتمد دليل الفئات هذا على مواصفة AUTOSAR بالنسخة R25-11 وجرى تنقيحه بواسطة الذكاء الاصطناعي.
Pushes back a DiagnosticSovdContentElementData with signed int as primitive type. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
Clears the Array. This DiagnosticSovdContentElementData shall be of type ArrayContentElementData
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6da40b1d207aالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُفرغ دالة العضو Clear للفئة ara::diag::DiagnosticSovdArrayContentElementDataView المحتوى بالكامل لعنصر مصفوفة SOVD ([SWS_DM_02233]). يتم توفير الاستدعاء عبر ملف الترويسة #include "ara/diag/diagnostic_sovd_content_element_data.h". تمتلك الطريقة التوقيع auto Clear () noexcept -> void;. تعمل بشكل متزامن، ولا تقبل أي مَعلمات ولا تُرجع أي قيمة ([SWS_DM_02233]).
معالجة الأخطاء والشروط الحدية
وفقًا للمواصفة، تم تعريف الدالة على أنها آمنة من الاستثناءات (exception safe) ومزودة بالمحدد noexcept ([SWS_DM_02233]). وهي لا تُرجع رموز خطأ ولا ara::core::Result. كمتطلب ملزم، يجب أن يكون DiagnosticSovdContentElementData المشار إليه من النوع ArrayContentElementData ([SWS_DM_02233]). نظرًا لعدم الإشارة إلى أي أخطاء، يُرجح أن الالتزام بهذا النوع مضمون بالفعل في وقت الإنشاء بواسطة فئة العرض (View). سؤال Q-cdb2385e081c3456 (مفتوح)
التزامن
تصنف المواصفة الطريقة صراحة على أنها آمنة مؤشريًا (thread-safe) ([SWS_DM_02233]). بالتالي، يمكن أن تتم استدعاءات Clear بشكل متزامن من عدة خيوط دون مزامنة خارجية.
التكامل والتفاعل في النظام الفرعي للتشخيص
ضمن بنيات بيانات SOVD، ترتبط العملية ارتباطًا وثيقًا بطرق الحذف الأخرى:
يمثل DiagnosticSovdContentElementData::Clear ([SWS_DM_02338]) النظير العام على مستوى العنصر، ولكنه يُرجع ara::core::Result<void> ويفشل إذا لم يكن الكائن مصفوفة.
يتولى DiagnosticSovdRecordContentElementDataView::Clear ([SWS_DM_02276]) إجراء التنظيف المماثل لهياكل البيانات من النوع RecordContentElementData أو ContentData.
في سياق ذاكرة الأخطاء التقليدية، يُستخدم ara::diag::DTCInformation::Clear ([SWS_DM_00671]) في المقابل للتنظيف غير المتزامن لرموز DTC الخاصة بـ UDS عبر ara::core::Future.
أُنشئت ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR Adaptive بالنسخة R25-11.
Erases a content element from DiagnosticSovdContentElementData. The current element shall be of ArrayContentElementData
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 413be4c2f44cالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الدالة Erase للفئة ara::diag::DiagnosticSovdArrayContentElementDataView لإزالة عنصر من بيانات محتوى SOVD التشخيصية ([SWS_DM_02247]، SWS Diagnostics §8.60.5.1.1.8 «Erase»). وتستقبل الدالة كمعلمة مكررًا من النوع DiagnosticSovdArrayContentElementDataIterator، والذي يشير إلى العنصر المراد حذفه. يتم الاستدعاء كعملية متزامنة؛ ويُرجح أن ينتج ذلك من الإرجاع المباشر لـ ara::core::Result<void> دون نمط Future غير متزامن. سؤال Q-28de22574e525c78 (مفتوح)
معالجة الأخطاء والشروط الحدية
تم الإعلان عن الدالة باستخدام noexcept ولها الخصائص exception safe وthread-safe ([SWS_DM_02247]). إذا فشل الحذف، تعيد الطريقة خطأً عبر ara::core::Result المُرجع. وتكون هذه هي الحالة إذا لم يكن DiagnosticSovdContentElementData الأصلي من النوع المطلوب ArrayContentElementData أو تعذر إزالة العنصر لأسباب أخرى ([SWS_DM_02247]).
تفاعل
ضمن واجهة SOVD، تتوافق هذه العملية مع دالة الحذف Erase لحاوية البيانات الأساسية DiagnosticSovdContentElementData لعناصر المصفوفة ([SWS_DM_02352]). أما بالنسبة لبنى السجلات (Record-Strukturen)، فتوجد نظائر مماثلة مع DiagnosticSovdRecordContentElementDataView::Erase وكذلك دالة الحاوية المطابقة ([SWS_DM_02294]، [SWS_DM_02374]).
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR.
Pushes back a DiagnosticSovdContentElementData with signed int as primitive type. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c37b8f1a434cالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم دالة العضو المتزامنة PushBack لإلحاق عنصر عدد صحيح بعلامة من النوع std::int64_t ببنية مصفوفة من عناصر محتوى SOVD للتشخيص ([SWS_DM_02241]، AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.14 «PushBack»). تم الإعلان عنها في ملف الترويسة ara/diag/diagnostic_sovd_content_element_data.h وتم تعريفها كـ noexcept ([SWS_DM_02241]).
لإجراء استدعاء ناجح، تنطبق المتطلبات الأساسية ومتطلبات الواجهة التالية:
سياق الاستدعاء والشروط المسبقة: يجب أن يمثل الكائن الهدف للفئة ara::diag::DiagnosticSovdArrayContentElementDataViewArrayContentElementData، ويجب أن يطابق النوع الأولي المراد إضافته نوع العنصر المحدد في الدالة الإنشائية ([SWS_DM_02241]).
قيمة الإرجاع ومعالجة الأخطاء: تُعيد الدالة ara::core::Result<void>. إذا فشل التحقق لأن العنصر الأساسي ليس من النوع ArrayContentElementData، فإن النتيجة تحتوي على خطأ ([SWS_DM_02241]). تفسير: يُرجّح أن يتم الإبلاغ عن أي تعارض مع نوع البيانات المحدد مسبقًا في الدالة الإنشائية كخطأ في كائن النتيجة بشكل مماثل. سؤال Q-d4715ecbd0f12d26 (مفتوح)
التزامن: تم تحديد الدالة على أنها thread-safe وكذلك exception-safe ([SWS_DM_02241]).
تُعد الطريقة جزءًا من عائلة من التحميلات الزائدة محددة النوع داخل DiagnosticSovdArrayContentElementDataView للأعداد الصحيحة بدون علامة ([SWS_DM_02242])، وأرقام الفاصلة العائمة ([SWS_DM_02243])، والقيم المنطقية ([SWS_DM_02244])، والسلاسل النصية ([SWS_DM_02245])، وعناصر البيانات الكاملة ([SWS_DM_02246]). وتوجد طرق مقابلة أيضًا على فئة البيانات DiagnosticSovdContentElementData نفسها ([SWS_DM_02346]).
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R25-11.
Pushes back a DiagnosticSovdContentElementData with unsigned int as primitive type. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c25599049c83المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُضيف دالة API المتزامنة PushBack للفئة ara::diag::DiagnosticSovdArrayContentElementDataView قيمة عدد صحيح بدون علامة من 64 بت (std::uint64_t) كعنصر بيانات أولي إلى نهاية عنصر مصفوفة SOVD موجود [SWS_DM_02242]. يتم التضمين عبر ملف الترويسة ara/diag/diagnostic_sovd_content_element_data.hSWS Diagnostics §8.60.5.1.1.15 «PushBack». الشرط الأساسي لنجاح الاستدعاء هو أن يمثل العنصر الحالي ArrayContentElementData وأن تطابق القيمة المراد إضافتها نوع العنصر المحدد في الدالة الإنشائية [SWS_DM_02242].
معالجة الأخطاء والتزامن
تشير الدالة إلى حالة تنفيذها عبر ara::core::Result<void>[SWS_DM_02242]. وإذا لم يكن الكائن الهدف من النوع ArrayContentElementData، تُرجع الدالة خطأً في النتيجة [SWS_DM_02242]. ونظرًا لعدم ذكر أي رموز أخطاء محددة (تفسير: يُشار إلى حالات الخطأ بشكل عام عبر Result)، يجب على المستدعي تقييم كائن النتيجة Result. سؤال Q-95f2dd96e2681368 (مفتوح) تم الإعلان عن الدالة كـ noexcept، وتضمن أمان الاستثناءات (Exception-Sicherheit)، كما أنها محددة صراحةً بأنها آمنة مؤشريًا (threadsicher) [SWS_DM_02242].
تفاعل
تنتمي هذه العملية إلى فئة من التحميلات الزائدة المحددة حسب النوع داخل DiagnosticSovdArrayContentElementDataView، والتي تعالج بالمثل أعدادًا صحيحة ذات إشارة عبر std::int64_t[SWS_DM_02241]، وأعدادًا فاصلة عائمة عبر double[SWS_DM_02243]، وقيمًا منطقية عبر bool[SWS_DM_02244]، وسلاسل نصية عبر ara::core::StringView[SWS_DM_02245]، أو عناصر مهيكلة من النوع DiagnosticSovdContentElementData[SWS_DM_02246]. وعلاوة على ذلك، يتم توفير تنفيذ مماثل لـ std::uint64_t بواسطة DiagnosticSovdContentElementData[SWS_DM_02347].
تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند حصريًا إلى بيانات المواصفة من AUTOSAR R25-11.
auto PushBack (double content_element) noexcept -> ara::core::Result< void >;
Pushes back a DiagnosticSovdContentElementData with double as primitive type. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 57dd45f522f9المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
يتم توفير الدالة المتزامنة PushBack عبر ملف الترويسة #include "ara/diag/diagnostic_sovd_content_element_data.h" في نطاق الفئة ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02243]، AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.13 «PushBack»). وهي تُلحق قيمة فاصلة عائمة أولية من النوع double كعنصر محتوى بمصفوفة موجودة ([SWS_DM_02243]). معلمة التمرير الوحيدة هي البيانات المراد إلحاقها content_element.
معالجة الأخطاء والشروط الحدية
تُرجع الدالة ara::core::Result<void> ([SWS_DM_02243]). يتطلب التنفيذ الناجح أن يكون العنصر الحالي من النوع ArrayContentElementData وأن يتطابق العنصر المراد إضافته مع النوع المحدد في منشئ ArrayContentElementData ([SWS_DM_02243]). وطالما أن الهدف ليس من النوع ArrayContentElementData، فإن العملية تفشل وتُرجع خطأً في النتيجة ([SWS_DM_02243]).
التزامن
تم الإعلان عن الدالة كـ noexcept، وهي تضمن أمان الاستثناءات (exception safe)، كما أنها آمنة مؤشريًا (thread-safe) وفقًا للمواصفة ([SWS_DM_02243]). بالتالي، يمكن لخيوط متعددة استدعاء الدالة بشكل متزامن دون مزامنة خارجية.
تفاعل
توجد داخل DiagnosticSovdArrayContentElementDataView تحميلات زائدة مطابقة للنوع لأنواع بيانات أولية أخرى، من بينها std::int64_t ([SWS_DM_02241])، وstd::uint64_t ([SWS_DM_02242])، وbool ([SWS_DM_02244])، وara::core::StringView ([SWS_DM_02245])، بالإضافة إلى كائنات DiagnosticSovdContentElementData كاملة ([SWS_DM_02246]). وتتوفر دوال مماثلة أيضًا في DiagnosticSovdContentElementData (مثل [SWS_DM_02348]).
تم توليد هذا النص بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.
auto PushBack (bool content_element) noexcept -> ara::core::Result< void >;
Pushes back a DiagnosticSovdContentElementData with boolean as primitive type. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 1dba5c9a049dالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم دالة العضو PushBack لإلحاق DiagnosticSovdContentElementData بنوع البيانات الأولي bool بعنصر مصفوفة موجود ([SWS_DM_02244]). تم تعريف الواجهة في الترويسة ara/diag/diagnostic_sovd_content_element_data.h داخل الفئة ara::diag::DiagnosticSovdArrayContentElementDataView (AUTOSAR_AP_SWS_Diagnostics §8.60.5.1.1.12 «PushBack»). وتستقبل الدالة المتزامنة القيمة المنطقية content_element كمعلمة إدخال ([SWS_DM_02244]).
يُشترط للاستدعاء أن يكون العنصر الحالي من النوع ArrayContentElementData وأن تتطابق القيمة المراد إلحاقها مع النوع الذي تم الإعلان عنه في منشئ بنية البيانات ([SWS_DM_02244]). وإذا لم يكن العنصر الهدف من النوع ArrayContentElementData، تفشل العملية وتُرجع ara::core::Result<void> مع خطأ مطابق؛ وفي حالة النجاح، تحتوي النتيجة على void فارغ ([SWS_DM_02244]).
فيما يتعلق بأمان التنفيذ، تم الإعلان عن الدالة كـ noexcept وتحديدها بأنها آمنة مؤشريًا (thread-safe) وآمنة استثنائيًا (exception safe) ([SWS_DM_02244]).
الدالة جزء من فئة من التحميلات الزائدة ذات الأنواع لـ PushBack داخل DiagnosticSovdArrayContentElementDataView. وإلى جانب القيم المنطقية، تغطي الدوال الشقيقة إدراج أنواع الأعداد الصحيحة مثل std::int64_t ([SWS_DM_02241]) وstd::uint64_t ([SWS_DM_02242])، وقيم الفاصلة العائمة double ([SWS_DM_02243])، والسلاسل النصية ara::core::StringView ([SWS_DM_02245])، بالإضافة إلى عناصر البيانات المعقدة ([SWS_DM_02246]). وعلاوة على ذلك، تتوفر عمليات مقابلة على مستوى DiagnosticSovdContentElementData، بما في ذلك المتغير المنطقي [SWS_DM_02349].
تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR R25-11.
Pushes back a DiagnosticSovdContentElementData with string as primitive type. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 265380479cb5المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُلحق دالة العضو المتزامنة PushBack للفئة ara::diag::DiagnosticSovdArrayContentElementDataView ([SWS_DM_02245]، المعرفة في SWS Diagnostics §8.60.5.1.1.11 «PushBack») عنصرًا جديدًا بالنوع الأولي سلسلة نصية بمصفوفة SOVD تشخيصية. ولهذا الغرض يجب تضمين ملف الرأس ara/diag/diagnostic_sovd_content_element_data.h. تأخذ الدالة العنصر المراد إضافته عبر المعامل content_element من النوع ara::core::StringView.
معالجة الأخطاء
يُستخدم ara::core::Result<void> كنوع إرجاع. يتم إرجاع خطأ في كائن النتيجة إذا لم يكن الكائن الحالي من النوع ArrayContentElementData أو لم يتطابق نوع العنصر الممرر مع نوع العنصر المحدد في منشئ ArrayContentElementData ([SWS_DM_02245]).
التزامن والقيود
أُعلنت الدالة بالمحدد noexcept. وهي توفر أمان استثناءات مضمونًا (exception safe) ومحددة بأنها آمنة تمامًا من حيث خيوط التنفيذ (thread-safe) ([SWS_DM_02245]).
تفاعل
العملية جزء من عائلة من الطرق ذات التحميل الزائد. داخل DiagnosticSovdArrayContentElementDataView، توجد تحميلات زائدة أخرى للأنواع القياسية مثل std::int64_t ([SWS_DM_02241])، وstd::uint64_t ([SWS_DM_02242])، وdouble ([SWS_DM_02243])، وbool ([SWS_DM_02244])، بالإضافة إلى عناصر كاملة من النوع DiagnosticSovdContentElementData ([SWS_DM_02246]). علاوة على ذلك، توفر الفئة ara::diag::DiagnosticSovdContentElementData أيضًا واجهة PushBack مماثلة للسلاسل النصية ([SWS_DM_02350]).
تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.
Pushes back a DiagnosticSovdContentElementData. The current element shall be of ArrayContentElementData and the element to add of the specified in the ArrayContentElementData constructor
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 016f2212a535المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُلحق دالة العضو المتزامنة PushBack للفئة ara::diag::DiagnosticSovdArrayContentElementDataView (SWS Diagnostics §8.60.5.1.1.10 «PushBack») عنصرًا من النوع DiagnosticSovdContentElementData بعرض بيانات مصفوفة موجود ([SWS_DM_02246]). وتستقبل الكائن المراد إضافته content_element بالقيمة كمعلمة تمرير، وليس لها قيمة إرجاع (void). يتم توفير الإعلان عبر ملف الترويسة ara/diag/diagnostic_sovd_content_element_data.h.
التزامن والشروط المسبقة
تُعرّف المواصفة الدالة بأنها آمنة استثنائيًا (exception safe)، وآمنة مؤشريًا (thread-safe)، ومميّزة بـ noexcept ([SWS_DM_02246]). وكشرط مسبق ملزم، تتطلب العملية أن يكون العنصر الحالي من النوع ArrayContentElementData وأن يتطابق العنصر المراد إلحاقه تمامًا مع النوع الذي تم تحديده في منشئ ArrayContentElementData ([SWS_DM_02246]).
معالجة الأخطاء والتفاعل
على عكس التحميلات الزائدة للأنواع الأولية مثل std::int64_t ([SWS_DM_02241])، أو std::uint64_t ([SWS_DM_02242])، أو double ([SWS_DM_02243])، أو bool ([SWS_DM_02244])، أو ara::core::StringView ([SWS_DM_02245])، التي تُرجع ara::core::Result<void> لنقل الخطأ، تُرجع هذه الدالة void. وبالتالي، من المرجح أن تقع على عاتق المستدعي مسؤولية التحقق مسبقًا من توافق النوع، نظرًا لأن أخطاء وقت التشغيل في هذه الواجهة لا تتم الإشارة إليها عبر نوع Result. سؤال Q-00739dff7d34e242 (مفتوح) كما تم تعريف دالة مكافئة لإلحاق عناصر البيانات في DiagnosticSovdContentElementData أيضًا ([SWS_DM_02351]).
تم إنشاء هذا النص تلقائيًا. وتستند جميع الإفادات الفنية إلى مواصفة AUTOSAR AP R25-11.
auto Reserve (std::size_t capacity) noexcept -> void;
Reserves the capacity of the DiagnosticSovdArrayContentElementData.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b3494a8080d3المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الطريقة المتزامنة Reserve للفئة ara::diag::DiagnosticSovdArrayContentElementDataView للتخصيص المسبق للسعة التخزينية لعناصر بيانات المصفوفة ([SWS_DM_02240]، SWS Diagnostics §8.60.5.1.1.16 «Reserve»). وتُوفَّر عبر الترويسة #include "ara/diag/diagnostic_sovd_content_element_data.h" وتستقبل المعامل capacity من النوع std::size_t، الذي يحدد السعة المطلوب توفيرها لـ DiagnosticSovdArrayContentElementData الأساسية ([SWS_DM_02240]). ولا تُرجَع قيمة إرجاع ([SWS_DM_02240]).
فيما يتعلق بمعالجة الأخطاء، أُعلنت الدالة على أنها آمنة من الاستثناءات (exception safe) وكذلك noexcept ([SWS_DM_02240]). وهي لا تستخدم رموز خطأ عبر ara::core::Result ولا استثناءات ++C. تفسير: في حال حدوث نقص في الذاكرة، يُرجح أن يفشل التخصيص داخليًا أو يؤدي إلى إنهاء البرنامج، نظرًا لعدم توفر قناة أخطاء لجهة الاستدعاء. سؤال Q-348805197c004eea (مفتوح)
بالنسبة للتزامن، حُددت العملية صراحةً على أنها آمنة خيطيًا (thread-safe) ([SWS_DM_02240]). وبالتالي يمكن إجراء الاستدعاءات دون قفل خارجي من خيوط متوازية.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني