क्लास ara::core::Map::value_compare

सहायक क्लास ara::core::Map::value_compare आंतरिक रूप से इनकैप्सुलेटेड तुलना प्रेडिकेट [SWS_CORE_01421] का उपयोग करके किसी Map के दो मान युग्मों की उनकी कुंजियों के आधार पर रिलेशनल तुलना करने के लिए एक फ़ंक्शन ऑब्जेक्ट के रूप में कार्य करती है। इंस्टैंसिएशन मुख्य रूप से पैरेंट Map संरचना द्वारा सुरक्षित रूप से किया जाता है, जबकि कॉलर कॉल ऑपरेटर operator() [SWS_CORE_01423] के माध्यम से मूल्यांकन निष्पादित करते हैं। चूंकि विनिर्देश के अनुसार संचालन अपवाद-सुरक्षित नहीं हैं, इसलिए कॉलिंग कोड को अंतर्निहित प्रेडिकेट के संभावित अपवादों को ध्यान में रखना चाहिए।

अधिक ›

संदर्भ

सहायक क्लास ara::core::Map::value_compare AUTOSAR Adaptive Platform के मॉड्यूल core में एक फ़ंक्शन ऑब्जेक्ट प्रदान करती है, जिसकी मदद से किसी एसोसिएटिव टेबल के दो पूर्ण कुंजी-मान तत्वों (value_type) की तुलना की जा सकती है। विनिर्देश के अनुसार, यह क्लास [map] के लिए C++ मानक लाइब्रेरी के स्थापित व्यवहार का अनुसरण करती है। केंद्रीय कार्य कुंजियों के क्रम के लिए परिभाषित Compare प्रकार के प्रेडिकेट को संपूर्ण मान युग्मों पर लागू करने योग्य बनाना है। इसके लिए, क्लास संरक्षित सदस्य चर comp [SWS_CORE_01421] में इस प्रेडिकेट के एक आंतरिक इंस्टेंस को समाहित करती है। इस प्रकार, value_compare सीधे मूल डेटा संरचना ara::core::Map के साथ इंटरैक्ट करता है और बाहरी रूप से सुनिश्चित करता है कि सॉर्टिंग या खोज एल्गोरिदम उनकी कुंजियों के आधार पर मान युग्मों की निरंतर तुलना कर सकें।

जीवनचक्र

value_compare का इंस्टैंसिएशन सख्त पहुँच प्रतिबंधों के अधीन है: कंस्ट्रक्टर value_compare(Compare c) को protected विजिबिलिटी प्रदान की गई है [SWS_CORE_01422]। व्याख्या: इस संरक्षित विजिबिलिटी के कारण, नए इंस्टेंस का निर्माण मुख्य रूप से संलग्न क्लास ara::core::Map के लिए ही आरक्षित होना चाहिए, जबकि सामान्य कॉलर Map से तैयार फ़ंक्शन ऑब्जेक्ट प्राप्त करते हैं। प्रश्न Q-f188cfa9cf627a11 (खुला) निर्माण के समय, ऑब्जेक्ट तुलना प्रेडिकेट को स्वीकार करता है और इसे संरक्षित चर comp [SWS_CORE_01421] में संग्रहीत करता है। जटिल स्थिति परिवर्तनों वाला कोई जीवनचक्र मौजूद नहीं है; इंस्टेंस अपने निर्माण के बाद एक अपरिवर्तनीय निष्पादन स्थिति में रहता है। समवर्ती संचालन के लिए, इसका मतलब है कि कॉल ऑपरेटर के माध्यम से समानांतर रीड एक्सेस गैर-महत्वपूर्ण हैं, जब तक कि इनकैप्सुलेटेड प्रेडिकेट Compare स्टेटलेस या थ्रेड-सुरक्षित रूप से काम करता है।

उपयोग पथ

नियमित उपयोग पथ फ़ंक्शन कॉल ऑपरेटर operator() [SWS_CORE_01423] के माध्यम से मान युग्मों के बार-बार मूल्यांकन पर केंद्रित है। इसे एक const मेथड के रूप में घोषित किया गया है और यह value_type प्रकार के निरंतर तत्वों के दो संदर्भ स्वीकार करता है। व्याख्या: निष्पादन के समय, operator() दोनों पास किए गए मान युग्मों के कुंजी भागों तक पहुँचता है और रिलेशनल परिणाम को बूलियन मान के रूप में वापस करने के लिए उन्हें comp में संग्रहीत प्रेडिकेट [SWS_CORE_01421] को पास करता है। प्रश्न Q-207114486c204301 (खुला) निम्नलिखित आरेख इस मानकीकृत प्रक्रिया को दिखाता है:

अनुक्रम आरेख: operator() और इनकैप्सुलेटेड प्रेडिकेट comp के माध्यम से मान तुलना का प्रवाह। स्रोत: [SWS_CORE_01421], [SWS_CORE_01423]

यह पथ आमतौर पर उन एल्गोरिदम में उपयोग किया जाता है जिन्हें उनके सॉर्टिंग क्रम के आधार पर किसी Map के तत्वों की जांच या पुनरावृत्ति (traverse) करनी होती है, बिना उपयोगकर्ता द्वारा मान युग्मों से कुंजियों को मैन्युअल रूप से डीरेफ़रेंस किए।

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

मजबूती और अपवाद हैंडलिंग के संबंध में, यह ध्यान दिया जाना चाहिए कि न तो कंस्ट्रक्टर [SWS_CORE_01422] और न ही कॉल ऑपरेटर operator() [SWS_CORE_01423] अपवाद-सुरक्षित के रूप में निर्दिष्ट हैं; दोनों को स्पष्ट रूप से "not exception safe" के रूप में वर्गीकृत किया गया है। व्याख्या: व्यवहार में इसका अर्थ यह है कि क्लास किसी भी स्वयं के अपवाद हैंडलिंग तंत्र को इनकैप्सुलेट नहीं करती है और उपयोगकर्ता-परिभाषित प्रेडिकेट Compare की प्रतिलिपि बनाते या निष्पादित करते समय ट्रिगर होने वाले अपवाद सीधे कॉलर को प्रचारित किए जाते हैं। प्रश्न Q-427fd0afbba7bf9e (खुला) विनिर्देश इस सहायक क्लास के लिए किसी विशिष्ट त्रुटि कोड को परिभाषित नहीं करता है। त्रुटि रहित संचालन के लिए एक आवश्यक पूर्वशर्त के रूप में, पास किए गए प्रेडिकेट Compare की त्रुटि-मुक्त इंस्टैंसिएशन क्षमता और निष्पादन क्षमता के साथ-साथ operator() को पास किए गए value_type के संदर्भों की वैधता लागू होती है।