بنية std::hash< ara::core::String >

يُستخدم التخصيص std::hash< ara::core::String > لحساب قيم تجزئة من أعداد صحيحة لمثيلات ara::core::String في الوحدة النمطية core. ويتيح الدمج السلس لنوع السلسلة النصية الخاص بالمنصة التكيفية في الحاويات القياسية غير المرتبة. وبصفته كائن دالة عديماً للحالة ومُعلناً كـ final، فإنه لا يمتلك دورة حياة معقدة ولا يتطلب للتقييم الحتمي سوى سلسلة نصية صالحة.

المزيد ›

السياق

تمثل البنية std::hash< ara::core::String > تخصيص قالب لفئة دالة C++ القياسية std::hash للنوع ara::core::String داخل الوحدة النمطية core لـ Adaptive Platform. ووفقاً للبنية المعمارية العامة لمكتبات C++ القياسية، فإنها تعمل ككائن دالة تجزئة يعين مثيلات السلاسل النصية إلى قيم تجزئة من أعداد صحيحة. وتتمثل أطراف التفاعل النموذجية في الحاويات الترابطية القياسية، مثل المجموعات أو الخرائط غير المرتبة، والتي تعتمد على واجهات تجزئة قياسية للفهرسة السريعة وتوزيع العناصر. وقد حُدد الإعلان كـ final، بحيث يُستبعد أي اشتقاق إضافي من هذا التخصيص.

تفسير: نظراً لعدم تضمين متطلبات صريحة أو مراجع وثائقية في مقتطف المواصفات الحالي، يُرجح أن يندمج دور التخصيص بسلاسة في دلالات المكتبة القياسية المعتادة لـ std::hash وأن يخدم في المقام الأول إمكانية التشغيل البيني بين ara::core::String وبنى البيانات القائمة على التجزئة. سؤال Q-6d2835413a6e35a5 (مفتوح)

دورة الحياة

بصفته كائن دالة عديماً للحالة، لا يخضع std::hash< ara::core::String > لمراحل دورة حياة معقدة أو انتقالات حالة ديناميكية. ويمكن إنشاء مثيلات للبنية عند الحاجة أو إنشاؤها ككائنات دوال مؤقتة وتدميرها مباشرةً بعد الحساب. ولا توجد علاقات ملكية دائمة للسلاسل النصية الممررة. وبما أن البنية عديمة الحالة، يُرجح أن يكون استدعاء عامل الدالة لمثيلات ثابتة من ara::core::String آمناً في جوهره من حيث التزامن والتشعب الخيطي، طالما لم يتم تعديل السلسلة النصية الأساسية بشكل متزامن أثناء حساب التجزئة. سؤال Q-bec5dd50aaf196d9 (مفتوح)

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

يتم الاستخدام النظامي لـ std::hash< ara::core::String > إما ضمنياً عبر الحاويات الترابطية أو من خلال إنشاء مثيل صريح لتحديد قيمة التجزئة لسلسلة نصية:

• إنشاء مثيل صالح من ara::core::String أو الإشارة إليه.
• إنشاء مثيل لكائن الدالة std::hash< ara::core::String > أو الاستخدام الضمني كمعامل تجزئة قياسي في الحاويات القياسية غير المرتبة.
• تنفيذ عامل الاستدعاء مع تمرير السلسلة النصية لإرجاع قيمة التجزئة المحسوبة.

تفسير: من المحتمل أن يتبع التسلسل هنا النمط المعتاد لكائنات دوال C++ دون خطوات تكوين أو تهيئة إضافية. سؤال (مفتوح)

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

يتطلب حساب قيمة التجزئة أن يكون مثيل السلسلة النصية الممرر ara::core::String صالحاً. ولا توجد حالات خطأ أو رموز خطأ محددة بالمعنى المقصود في ara::core::ErrorCode مبينة لهذا التخصيص في الحمولة. واستناداً إلى المتطلبات القياسية لدوال التجزئة، يُفترض أن الحساب يتم بشكل حتمي ولا يطلق استثناءات في الوضع الطبيعي، بشرط ضمان الوصول إلى منطقة ذاكرة السلسلة النصية.