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_00701] لم يُستورد النص بعدUpstream: RS_SHWA_00017
template <int Dimensions = 1> class Id final {...};
Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 5df852eb2decالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يغلّف قالب الفئة ara::shwa::Id المعرّفات متعددة الأبعاد في الوحدة shwa ويفرض إنشاء نسخ منضبطاً عبر دوال مصنع استاتيكية مثل Create[AP_SWS_SHWA_00707]. وبصفته كائن قيمة قابلاً للنسخ والنقل، فإنه يسمح بالوصول إلى فهارس الأبعاد الفردية بواسطة Get وSet[AP_SWS_SHWA_00710]. ونظراً لأن عمليات القراءة والكتابة وكذلك المصانع متعددة الأبعاد ليست آمنة خيطياً، فإن المزامنة اللازمة تقع على عاتق التطبيق المستدعي.
السياق
يمثل قالب الفئة ara::shwa::Id ضمن الوحدة shwa تعريضاً أو فهرسة متعددة الأبعاد لهياكل الذاكرة المشتركة أو مسرعات العتاد. وهو يغلّف إحداثيات أو فهارس أبعاد يمكن إنشاؤها عبر دوال مصنع استاتيكية ثم الاستعلام عنها أو تعديلها لاحقاً. تم الإعلان عن الفئة بصفتها final وتحدد عدد الأبعاد عبر معامل القالب Dimensions بالقيمة الافتراضية 1. وعادة ما تظهر مكونات التطبيق كأطراف تفاعل تحتاج إلى عنونة وصول منظم إلى مخازن المسرع المؤقتة أو موارد الذاكرة. ويعمل كائن النسخة من ara::shwa::Id هنا ككائن قيمة مدمج للعنونة المرتبطة بالأبعاد.
فيما يتعلق بملكية الموارد، يتصرف ara::shwa::Id ككائن قيمة قياسي. فهو ينفذ كلاً من دالة إنشاء النسخ [AP_SWS_SHWA_00703] ومعامل تعيين النسخ [AP_SWS_SHWA_00704] كمعياريين (default) وآمنين ضد الاستثناءات (noexcept). وبالمثل، تتوفر دالة الإنشاء بالحركة [AP_SWS_SHWA_00705] ومعامل التعيين بالحركة [AP_SWS_SHWA_00706] مع noexcept. وبالتالي يمكن تخزين النسخ بكفاءة في حاويات، أو تمريرها بالقيمة، أو نقلها بين أجزاء البرنامج. ويتطلب الأمان الخيطي اهتماماً خاصاً: فبينما تم تحديد دالة المصنع أحادية البعد بأنها آمنة خيطياً [AP_SWS_SHWA_00707]، فإن دوال المصنع ثنائية وثلاثية الأبعاد صُنفت صراحة بأنها غير آمنة خيطياً [AP_SWS_SHWA_00708]، [AP_SWS_SHWA_00709]. وعند التهيئة المتوازية للفهارس متعددة الأبعاد، يجب على الجهات المستدعية اتخاذ تدابير المزامنة المناسبة.
مسار الاستخدام
يتضمن تسلسل الاستخدام النموذجي الإنشاء المنضبط عبر استدعاء المصنع المناسب، والتحقق من كائن Result، بالإضافة إلى عمليات القراءة والكتابة اللاحقة على الأبعاد الفردية. في البداية، يستدعي التطبيق Create مع حدود الأبعاد أو قيم الفهارس المطلوبة. بعد الإرجاع الناجح لـ ara::core::Result<Id>، يتم فك القيمة الموجودة بداخله. عبر الدالة الثابتة Get، يمكن الاستعلام عن قيمة الفهرس لبُعد معين [AP_SWS_SHWA_00710]. وعند الحاجة، يمكن تعديل قيمة بُعد معين لاحقاً عبر Set[AP_SWS_SHWA_00711]. وقد تم تصنيف كلتا الدالتين (Get وSet) على أنهما غير آمنين خيطياً؛ ويجب مزامنة الوصول المتزامن إلى النسخة نفسها من خيوط متعددة خارجياً.
عند الإنشاء عبر دوال Create الاستاتيكية، قد تحدث أخطاء أثناء التشغيل. إذا فشل إنشاء النسخة، فإن دالة المصنع توفر ara::core::Result يحتوي على كود الخطأ ShwaErrorCode::kRuntime[AP_SWS_SHWA_00707]، [AP_SWS_SHWA_00708]، [AP_SWS_SHWA_00709]. ولذلك يجب على الجهات المستدعية فحص قيمة الإرجاع إلزامياً بواسطة HasValue() قبل الوصول إلى النسخة. تضمن جميع دوال Create دلالات التراجع (Rollback)، وتم الإعلان عنها كآمنة ضد الاستثناءات (noexcept).
أثناء التشغيل الفعلي مع الدالتين Get وSet، يجب الانتباه إلى أنهما وفقاً للمواصفة ليستا آمنتين ضد الاستثناءات (not exception safe) ولا تعملان بأمان خيطي [AP_SWS_SHWA_00710]، [AP_SWS_SHWA_00711]. تفسير: من المرجح أن يؤدي تمرير قيم أبعاد غير مسموح بها خارج نطاق القيم الصالح إلى سلوك غير محدد أو استثناءات، نظراً لعدم تعريف أكواد خطأ منفصلة للمعاملات الخاطئة في هذه الدوال. سؤال Q-6983f5f27702e6e8 (مفتوح) ويجب على الجهات المستدعية التأكد قبل الاستدعاء من أن الوسيط dimension يقع ضمن الحدود الصالحة للنسخة.
تم إنشاء هذا الدليل بواسطة مساعد ذكاء اصطناعي بناءً على مواصفة AUTOSAR للإصدار R25-11.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني