क्लास ara::diag::DiagnosticSovdArrayContentElementDataIterator

ara::diag::DiagnosticSovdArrayContentElementDataIterator वर्ग डायग्नोस्टिक सामग्री में SOVD ऐरे तत्वों पर चरण-दर-चरण पुनरावृत्ति के लिए कार्य करता है ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 “Class: DiagnosticSovdArrayContentElementDataIterator”)। यह DiagnosticSovdContentElementData के संदर्भ या पॉइंटर्स प्रदान करने के लिए तुलना, प्रीफ़िक्स इंक्रीमेंट द्वारा आगे बढ़ने और डीरेफ़रेंसिंग के लिए ऑपरेटर प्रदान करता है ([SWS_DM_02216], [SWS_DM_02220])। सभी फ़ंक्शन थ्रेड-सुरक्षित हैं और noexcept के रूप में निर्दिष्ट हैं, यही कारण है कि डीरेफ़रेंसिंग से पहले लक्ष्य सीमा की वैधता एप्लिकेशन द्वारा सुनिश्चित की जानी चाहिए।

अधिक ›

संदर्भ

ara::diag::DiagnosticSovdArrayContentElementDataIterator वर्ग SOVD-आधारित डायग्नोस्टिक संचार (Service-Oriented Vehicle Diagnostics) के भीतर ऐरे तत्वों के लिए एक विशिष्ट इटरेटर प्रदान करता है ([SWS_DM_02215], AUTOSAR_AP_SWS_Diagnostics §8.60.4 “Class: DiagnosticSovdArrayContentElementDataIterator”)। इसका प्राथमिक दायित्व डेटा ऐरे के तत्वों के माध्यम से क्रमिक रूप से नेविगेट करने के लिए मानकीकृत पुनरावृत्ति इंटरफ़ेस प्रदान करना है। इंटरैक्शन पार्टनर के रूप में कॉलिंग डायग्नोस्टिक एप्लिकेशन और DiagnosticSovdContentElementData प्रकार के संदर्भित लक्ष्य तत्व कार्य करते हैं ([SWS_DM_02216], [SWS_DM_02217])। इटरेटर हेडर ara/diag/diagnostic_sovd_content_element_data.h (AUTOSAR_AP_SWS_Diagnostics §8.60.4.1 “Public Member Functions”) में घोषित है।

जीवनचक्र

विनिर्देश ara::diag::DiagnosticSovdArrayContentElementDataIterator के लिए अपने स्वयं के किसी सार्वजनिक कंस्ट्रक्टर को परिभाषित नहीं करता है; इसलिए इंस्टेंस संबंधित SOVD कंटेनर संरचनाओं द्वारा उनकी इटरेटर विधियों के माध्यम से बनाए और प्रदान किए जाते हैं (व्याख्या)। प्रश्न Q-e1fbf51ab4acc197 (खुला) इटरेटर का स्वयं अंतर्निहित पेलोड डेटा पर कोई स्वामित्व नहीं होता है, बल्कि केवल मेमोरी में संबंधित तत्वों के संदर्भ होते हैं। इसलिए किसी इटरेटर इंस्टेंस की वैधता संभवतः पैरेंट डेटा संरचना के लाइफ़टाइम और वैधता से कड़ाई से जुड़ी होती है (व्याख्या)। प्रश्न Q-c01219664b4adc56 (खुला)

लाइफ़साइकिल और समवर्ती संचालन के संबंध में, सभी सदस्य फलनों को अपवाद-सुरक्षित (exception safe) और थ्रेड-सुरक्षित (thread-safe) के रूप में निर्दिष्ट किया गया है ([SWS_DM_02216], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220])। यह कई थ्रेड्स में एक साथ पढ़ने और आगे बढ़ाने के संचालन की अनुमति देता है, बशर्ते कि अंतर्निहित डेटा संरचना समवर्ती रूप से विनाशकारी तरीके से परिवर्तित न हो।

उपयोग पथ

नियमित प्रवाह C++ फ़ॉरवर्ड इटरेटर्स के विशिष्ट पैटर्न का अनुसरण करता है। अनुप्रयोग operator!= ([SWS_DM_02219]) या operator== ([SWS_DM_02218], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.5 “operator==”) के माध्यम से वर्तमान इटरेटर स्थिति की तुलना एंड-इटरेटर से करते हैं। यदि अंत तक अभी तक नहीं पहुँचा गया है, तो वर्तमान तत्व तक रीड-एक्सेस या तो DiagnosticSovdContentElementData के संदर्भ की वापसी के लिए डीरेफ़रेंसिंग operator* ([SWS_DM_02216]) के माध्यम से होती है या संगत पॉइंटर की वापसी के लिए एरो ऑपरेटर operator-> ([SWS_DM_02217], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.4 “operator->”) के माध्यम से होती है। इसके बाद, एप्लिकेशन प्रीफ़िक्स इंक्रीमेंट ऑपरेटर operator++ के साथ स्थिति को अगले ऐरे तत्व पर आगे बढ़ाता है ([SWS_DM_02220], AUTOSAR_AP_SWS_Diagnostics §8.60.4.1.1.3 “operator++”)।

अनुक्रम आरेख: SOVD ऐरे तत्वों पर पुनरावृत्ति लूप के दौरान कॉल अनुक्रम। स्रोत: [SWS_DM_02216], [SWS_DM_02219], [SWS_DM_02220]।

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

इटरेटर की सभी विधियाँ विनिर्देश noexcept के साथ प्रदान की गई हैं और परिभाषा के अनुसार कोई अपवाद नहीं फेंकती हैं ([SWS_DM_02216], [SWS_DM_02217], [SWS_DM_02218], [SWS_DM_02219], [SWS_DM_02220])। ara::core::ErrorCode जैसे त्रुटि कोड इन इंटरफ़ेस के लिए प्रदान नहीं किए गए हैं। शुद्धता एप्लिकेशन की कॉल स्थितियों पर निर्भर करती है: operator* या operator-> का उपयोग करके डीरेफ़रेंसिंग के लिए अनिवार्य पूर्व-शर्त यह है कि इटरेटर किसी मान्य ऐरे तत्व को इंगित करता हो न कि अंतिम स्थिति को; अमान्य इटरेटर्स तक पहुँचने से संभवतः अपरिभाषित व्यवहार हो सकता है (व्याख्या)। प्रश्न Q-63d87e38f9886f6b (खुला)