Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.
[AP_SWS_SHWA_01001] لم يُستورد النص بعدUpstream: RS_SHWA_00017
template <int Dimensions = 1> class Range final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
تغليف أحجام النطاقات التي تصل إلى ثلاثة أبعاد كنوع قيمة غير قابل للتغيير عبر إنشاء مصنعي متحكَّم به.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 9801add965b6المصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تغليف أحجام النطاقات التي تصل إلى ثلاثة أبعاد كنوع قيمة غير قابل للتغيير عبر إنشاء مصنعي متحكَّم به.
تُغلِّف الفئة أبعاد النطاقات متعددة الأبعاد وتمنع الاستنساخ بدون معلمات تمامًا [AP_SWS_SHWA_01002]. وتنشأ الكائنات بصورة متحكَّم بها عبر دوال مصنعية ثابتة، والتي تُرجع ShwaErrorCode::kRuntime في حالة الخطأ، وتوفر عند النجاح كائنات قيمة آمنة ضد الاستثناءات مع دلالات النسخ والنقل [AP_SWS_SHWA_01007]. وتُعد قراءة الأبعاد الفردية غير آمنة خيطيًا وتتطلب مزامنة خارجية [AP_SWS_SHWA_01010].
السياق
تمثل فئة القالب ara::shwa::Range ضمن وحدة Adaptive Platform shwa تحديدًا متعدد الأبعاد لنطاق أو حجم (يتم تحديد معلماته افتراضيًا عبر Dimensions = 1). وفي البنى القريبة من العتاد أو المشتركة في الذاكرة، يعمل كائن النطاق عادةً كوصف منظم للامتدادات الهندسية أو أبعاد المخزن المؤقت عبر ما يصل إلى ثلاثة محاور. وتتمثل أطراف التفاعل في المقام الأول في مكونات التطبيق وخدمات برامج التشغيل التي تحتاج إلى تخصيص مساحات الذاكرة أو تقسيمها أو عنونتها. وتُغلِّف الفئة الأبعاد المنفصلة وتوفر لها الحماية من الإنشاء المباشر الخاطئ، حيث يتم منع الكائنات غير المكتملة أو المهيأة بشكل غير صالح عبر قيود الواجهة.
دورة الحياة
تحدد دورة حياة نسخة ara::shwa::Range عبر متطلبات إنشاء صارمة. فالمُنشئ الافتراضي الخالي من المعلمات محذوف صراحةً [AP_SWS_SHWA_01002]، وبذلك يُستبعد الإنشاء المباشر دون تحديد الأبعاد. وبدلاً من ذلك، يتم الإنشاء حصريًا عبر دوال المصنع الثابتة Create، والتي تكون محملة بشكل زائد للإصدارات أحادية الأبعاد أو ثنائية الأبعاد أو ثلاثية الأبعاد: لبُعد واحد عبر dim0[AP_SWS_SHWA_01007]، ولِبُعدين عبر dim0 و dim1[AP_SWS_SHWA_01008]، ولثلاثة أبعاد عبر dim0 و dim1 و dim2[AP_SWS_SHWA_01009]. وتُرجع كل دالة من دوال المصنع هذه ara::core::Result<Range>.
بعد الإنشاء الناجح، تتصرف الفئة كنوع قيمة كامل (Value Type). فهي توفر كلاً من مُنشئ النسخ [AP_SWS_SHWA_01003] وعامل الإسناد بالنسخ [AP_SWS_SHWA_01004] كعمليات قياسية وآمنة ضد الاستثناءات (noexcept = default). وبشكل تكميلي، يتوفر مُنشئ نقل [AP_SWS_SHWA_01005] وعامل إسناد بالنقل [AP_SWS_SHWA_01006] مع نفس مستوى الأمان ضد الاستثناءات. وبذلك تمتلك النُّسخ دلالات قيمة واضحة ويمكن نقلها أو الاحتفاظ بها في الحاويات دون مشاكل. وفيما يتعلق بالتزامن، صُممت دوال المصنع الثابتة لتكون آمنة خيطيًا، بينما صنفت المواصفة دوال الفحص القارئة GetDimension0[AP_SWS_SHWA_01010]، و GetDimension1[AP_SWS_SHWA_01011]، و GetDimension2[AP_SWS_SHWA_01012] على أنها غير آمنة خيطيًا.
مسار الاستخدام
يتضمن مسار الاستخدام النموذجي إنشاء نسخة نطاق عبر الواجهة الثابتة، والتحقق من صحة النتيجة، ثم قراءة الأبعاد لخطوات التكوين أو التخصيص. ويوضح المخطط التسلسلي التالي هذا المسار.
في الخطوة الأولى، يستدعي التطبيق أحد التحميلات الزائدة للمصنع، على سبيل المثال Create(dim0)[AP_SWS_SHWA_01007] لنطاق أحادي البُعد أو Create(dim0, dim1)[AP_SWS_SHWA_01008] أو Create(dim0, dim1, dim2)[AP_SWS_SHWA_01009] للتكوينات متعددة الأبعاد. وتتحقق الطبقة المستدعية بعد ذلك من نجاح ara::core::Result المُرجَع. فإذا توفرت قيمة صالحة، يتم إلغاء مرجعية كائن Range أو نقله. وبعد ذلك، يمكن للدوال اللاحقة الاستعلام عن أحجام المحاور المضمنة عبر GetDimension0[AP_SWS_SHWA_01010] وكذلك عند الحاجة عبر GetDimension1[AP_SWS_SHWA_01011] و GetDimension2[AP_SWS_SHWA_01012] واستخدامها لعمليات المخزن المؤقت.
سيناريوهات الأخطاء
عند الإنشاء باستخدام Create، قد تطرأ حالات خطأ تؤدي إلى فشل التهيئة. وفي هذه الحالة، لا يُرجع المصنع كائنًا مهيأً، بل يُرجع نتيجة خطأ من النوع ShwaErrorCode::kRuntime ("General runtime error") [AP_SWS_SHWA_01007]، [AP_SWS_SHWA_01008]، [AP_SWS_SHWA_01009]. وبالنسبة لجميع متغيرات المصنع، تضمن المواصفة دلالات التراجع (Rollback) والأمان ضد الاستثناءات (noexcept)، بحيث لا تتبقى أي حالات جزئية أو تنشأ تناقضات عند حدوث خطأ.
بالنسبة لدوال الفحص GetDimension0[AP_SWS_SHWA_01010]، و GetDimension1[AP_SWS_SHWA_01011]، و GetDimension2[AP_SWS_SHWA_01012]، لم يتم توفير رموز خطأ للإرجاع، إلا أن المواصفة تصنفها على أنها غير آمنة ضد الاستثناءات (not exception safe) وغير آمنة خيطيًا (not thread-safe). ولذلك يتحمل المتصل شرطًا مسبقًا لتأمين الوصول عبر الخيوط المتعددة. بالإضافة إلى ذلك، يُرجَّح أن استدعاء استعلام عن بُعد يتجاوز عدد الأبعاد التي تم إنشاء نسخ منها باستخدام معلمة القالب Dimensions (على سبيل المثال GetDimension2 في تكوين أحادي البُعد) غير مسموح به ويؤدي إلى أخطاء. سؤال Q-794519baf2ea8a5e (مفتوح)
يستند هذا الدليل حصريًا إلى مواصفة واجهة ara::shwa::Range من AUTOSAR Adaptive R25-11.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني