क्लास std::hash< ara::core::Optional< T > >

टेम्पलेट विशेषज्ञता std::hash<ara::core::Optional<T>> C++ मानक लाइब्रेरी [SWS_CORE_01199] के सहयोगी हैश कंटेनरों में उपयोग के लिए वैकल्पिक मानों के लिए हैश मानों की गणना को सक्षम बनाती है। कॉल ऑपरेटर operator() के माध्यम से की जाती है, जो ara::core::Optional<T> के लिए एक निरंतर संदर्भ प्राप्त करता है और प्रकार size_t [SWS_CORE_01199] का एक हैश मान निर्धारित करता है। Interpretation: गणना को ऑप्शनल के असाइनमेंट के आधार पर या तो T के हैश फ़ंक्टर को सौंपना चाहिए या खाली इंस्टेंस के लिए एक निश्चित हैश मान प्रदान करना चाहिए। प्रश्न Q-f126709f8c243c75 (खुला) एक केंद्रीय सीमा शर्त के रूप में, इंटरफ़ेस एक सख्त noexcept विनिर्देश के माध्यम से पूर्ण अपवाद सुरक्षा की गारंटी देता है।

अधिक ›

संदर्भ

टेम्पलेट विशेषज्ञता std::hash<ara::core::Optional<T>> AUTOSAR Adaptive Platform [SWS_CORE_01199] के वैकल्पिक कंटेनर प्रकार के समर्थन के साथ C++ मानक लाइब्रेरी का विस्तार करती है। यह एक मानक-अनुरूप फ़ंक्शन ऑब्जेक्ट के रूप में कार्य करती है जो ara::core::Optional<T> के इंस्टेंस को मैप करती है और हैश-आधारित डेटा संरचनाओं में उनके उपयोग को सुनिश्चित करती है। प्राथमिक इंटरैक्शन पार्टनर के रूप में कंटेनर-आधारित एल्गोरिदम और सहयोगी स्टोरेज संरचनाएं जैसे std::unordered_set या std::unordered_map दिखाई देते हैं, जिन्हें आंतरिक स्टोरेज बकेट में तत्वों को वितरित करने के लिए एक नियतात्मक हैश मान की आवश्यकता होती है। परिभाषा को हेडर ara/core/optional.h के माध्यम से वैश्विक नेमस्पेस std [SWS_CORE_01199] में घोषित किया गया है और इस प्रकार यह AUTOSAR की कोर लाइब्रेरीज़ और आधुनिक C++ विकास परिवेशों के मानक कंटेनरों के बीच एक सीधा लिंक बनाती है।

जीवनचक्र

एक शुद्ध फ़ंक्शन ऑब्जेक्ट विशेषज्ञता के रूप में, std::hash<ara::core::Optional<T>> एक न्यूनतम जीवन चक्र की विशेषता रखती है। Interpretation: संरचना को एक साधारण, स्टेटलेस फ़ंक्शन ऑब्जेक्ट के रूप में डिज़ाइन किया जाना चाहिए जो न तो गतिशील मेमोरी आवंटित करता है और न ही अनन्य ऑपरेटिंग सिस्टम संसाधनों को बांधता है। प्रश्न Q-ad1c004a72b9f1b2 (खुला) इंस्टैंशिएशन आमतौर पर कॉल स्टैक पर अस्थायी रूप से या उच्च-स्तरीय कंटेनरों के भीतर एक टेम्पलेट पैरामीटर के रूप में अंतर्निहित रूप से होता है। चूंकि कोई आंतरिक स्थिति चर प्रबंधित नहीं होते हैं, इसलिए फ़ंक्टर का विनाश भी साधारण और दुष्प्रभावों से मुक्त होता है। एकमात्र कार्यात्मक प्रवेश बिंदु कॉल ऑपरेटर operator() है, जिसे एक निरंतर सदस्य फ़ंक्शन घोषित किया गया है [SWS_CORE_01199]। नतीजतन, कई समवर्ती थ्रेड्स अतिरिक्त सिंक्रोनाइज़ेशन तंत्र जैसे म्यूटेक्स या लॉक के बिना समानांतर में एक ही फ़ंक्टर इंस्टेंस को निष्पादित कर सकते हैं, जब तक कि हैश गणना के दौरान पास किए गए Optional इंस्टेंस अपरिवर्तित रहते हैं।

उपयोग पथ

नियमित उपयोग पथ बहु-चरणीय इनिशियलाइज़ेशन चरणों के बिना एक सीधे प्रवाह का पालन करता है। उपयोगकर्ता या एक सहयोगी कंटेनर फ़ंक्शन कॉल ऑपरेटर operator() [SWS_CORE_01199] को एक ara::core::Optional<T> ऑब्जेक्ट के निरंतर संदर्भ को पास करता है। ऑपरेटर तर्क को संसाधित करता है और तुरंत परिणाम को प्रकार size_t [SWS_CORE_01199] के पूर्णांक मान के रूप में लौटाता है।

अनुक्रम आरेख: ara::core::Optional<T> के लिए हैश मान गणना का विशिष्ट प्रवाह। स्रोत: [SWS_CORE_01199]

Interpretation: निष्पादन के समय, फ़ंक्टर संभवतः पहले पास किए गए Optional ऑब्जेक्ट की असाइनमेंट स्थिति की जांच करता है। प्रश्न (खुला) यदि ऑब्जेक्ट असाइन की गई स्थिति में है, तो फ़ंक्टर को संबंधित हैशिंग लॉजिक को सौंपकर T प्रकार के भीतर समाहित मान के हैश मान की गणना करनी चाहिए। यदि इसके विपरीत Optional खाली स्थिति में है, तो संभवतः एक स्थिर, पूर्वनिर्धारित हैश मान लौटाया जाता है। परिणामी प्रकार size_t मान तब कॉलिंग कंटेनर को सीधे लक्ष्य बकेट निर्धारित करने या कुंजी संरचनाओं की तुलना करने की अनुमति देता है।

त्रुटि परिदृश्य

त्रुटि प्रबंधन (error handling) और दृढ़ता (robustness) के संदर्भ में, यह विशेषज्ञता (specialization) सुरक्षा-महत्वपूर्ण प्रणालियों के लिए अधिकतम गारंटी प्रदान करती है। कॉल ऑपरेटर operator() स्पष्ट रूप से विनिर्देशक noexcept से सुसज्जित है और इसे अपवाद-सुरक्षित (“exception safe”) घोषित किया गया है [SWS_CORE_01199]। न तो त्रुटि कोड लौटाए जाते हैं, और न ही गणना के दौरान अपवाद उत्सर्जित किए जा सकते हैं। Interpretation: इस गैर-उत्सर्जन गारंटी (non-throwing guarantee) के लिए यह आवश्यक है कि अंतर्निहित प्रकार T का हैश फ़ंक्शन भी noexcept-शर्त को पूरा करता हो और कोई रनटाइम त्रुटियां उत्पन्न न करे। प्रश्न Q-d13957d23be4919e (खुला) यदि किसी प्रकार T के लिए std::hash की कोई मान्य विशेषज्ञता मौजूद नहीं है, तो इसके कारण संकलन के दौरान ही एक प्रकार त्रुटि (type error) उत्पन्न होती है। इस प्रकार रनटाइम पर कोई अप्रत्याशित अपवाद स्थितियां उत्पन्न नहीं होती हैं, जो त्रुटि-सहिष्णु Adaptive AUTOSAR अनुप्रयोगों में एक विश्वसनीय उपयोग सुनिश्चित करता है।