खरोंच से मेटास्टॉक के लिए एक DLL लिखना। भाग 2

यह आलेख हमारे फ़ंक्शन ( part1 , part3 ), मेटास्टॉक से डेटा प्राप्त करने, उन्हें संसाधित करने और मेटास्टॉक पर परिणाम वापस करने के नियमों के बारे में विस्तार से जांच करेगा। यह जानकारी MSX DLL में त्रुटियों से बचने में मदद करेगी।



हमारे कार्य का रूप है:

DLL_EXPORT BOOL __stdcall Price(const MSXDataRec *a_psBasic, const MSXDataInfoRecArgsArray *a_psArrayArgs, const MSXNumericArgsArray *a_psNumericArgs, const MSXStringArgsArray *a_psStringArgs, const MSXCustomArgsArray *a_psCustomArgs, MSXResultRec *a_psResult)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

जहाँ

* a_psBasic - MSXDataRec संरचना के लिए सूचक (प्रतिभूतियों पर सभी उपलब्ध डेटा);

* a_psArray - सूचक MSXDataInfoRecArgsArray संरचना (सरणी तर्क) के लिए;

* a_psNumeric - MSXNumericArgsArray संरचना (संख्यात्मक तर्क) के लिए सूचक;

* a_psString - MSXStringArgsArray संरचना (स्ट्रिंग तर्क) के लिए सूचक;

* a_psCustom - MSXCustomArgsArray संरचना (कस्टम तर्क) के लिए सूचक;

* a_psResult - MSXResultRec संरचना के लिए सूचक (डेटा प्रसंस्करण का परिणाम मेटास्टॉक पर लौट आया);

* a_psValue - MSXDataInfoRec संरचना के सूचक (गणना में प्रयुक्त सभी संख्यात्मक डेटा)।

सभी संरचना MSXStruc.h फ़ाइल में वर्णित हैं।

डेटा भंडारण और गणना

संकेतकों की गणना में उपयोग किए जाने वाले सभी संख्यात्मक डेटा को डेटा सरणियों के रूप में जाना जाता संरचनाओं में संग्रहीत किया जाता है। डेटा सरणियों का उपयोग मूल्य डेटा (उदाहरण के लिए, ओपन, उच्च, निम्न, आदि), संख्यात्मक स्थिरांक और संकेतक गणना परिणामों को संग्रहीत करने के लिए किया जाता है। जब मेटास्टॉक MSX DLL फ़ंक्शन की प्रतिभूतियों और तर्कों के बारे में डेटा की आपूर्ति करता है, तो इस डेटा को सरणियों के रूप में उपयोग किया जाता है। जब MSX DLL द्वारा गणना की गई फ़ंक्शन मेटास्टॉक में संकेतक के परिणाम लौटाता है, तो परिणाम डेटा की एक सरणी के रूप में वापस किया जाता है।

MSXDataInfoRec संरचना में डेटा सरणियाँ कार्यान्वित की जाती हैं और तीन मुख्य घटक होते हैं:

• डेटा तत्व - डेटा तत्व।

• पहला वैध सूचकांक - संदर्भ का प्रारंभिक बिंदु (Fvi)।

• अंतिम वैध सूचकांक - संदर्भ का अंतिम बिंदु (Lvi)।

डेटा आइटम डेटा सरणी से जुड़े वास्तविक संख्यात्मक मान हैं। ये मान सरणी में फ्लोट मान के रूप में संग्रहीत किए जाते हैं। पहले और अंतिम वैध सूचकांक का उपयोग यह निर्धारित करने के लिए किया जाता है कि कौन से डेटा आइटम में मान्य मूल्य हैं। पहले और अंतिम वैध सूचकांक (समावेशी) के बीच सभी डेटा तत्वों में वैध डेटा होता है। इस श्रेणी के बाहर के सभी तत्वों में अपरिभाषित मूल्य हैं और सभी गणनाओं के लिए इसे अनदेखा किया जाना चाहिए।

यदि Fvi <Lvi है तो डेटा ऐरे को " खाली " माना जाता है। खाली डेटासेट असामान्य नहीं हैं और उन्हें ठीक से संभाला जाना चाहिए। आमतौर पर, एक खाली डेटासेट में Fvi = 0 और Lvi = -1 होगा, हालाँकि Fvi <Lvi द्वारा प्रदान किए गए किसी भी संयोजन को खाली माना जाना चाहिए। डेटा उपलब्ध नहीं होने पर एक खाली डेटा सरणी दिखाई देती है। उदाहरण के लिए, एक 'ओपन इंटरेस्ट' डेटासेट का उपयोग सुरक्षा (सिक्योरिटीज) के लिए किया जाता है जिसमें ओपन इंटरेस्ट नहीं होता है।

या, यदि 100-अवधि की चलती औसत का परिणाम प्रतिभूतियों की कीमतों के डेटा के एक सरणी पर लागू होता है जिसमें 100 से कम तत्व होते हैं, तो हमें एक खाली डेटा सरणी मिलती है।

सूचक गणना के दौरान पहले और अंतिम वैध सूचकांक बहुत महत्वपूर्ण हैं। गणना हमेशा उनके बीच निहित डेटा तत्वों तक सीमित होनी चाहिए। लौटे डेटा सरणी के लिए Fvi और Lvi इंडेक्स को सही ढंग से सेट करने के लिए समझने के लिए दो महत्वपूर्ण बिंदु:

• हमेशा गणना की जाने वाली सभी इनपुट डेटा सरणियों की स्वीकार्य श्रेणियों की सीमा तक सीमित करें।

• गणना के परिणामस्वरूप Fvi और Lvi को इनपुट डेटा के सभी सरणियों के मूल्यों के संबंध में अपने पदों को बनाए रखना चाहिए।



MSXDataRec संरचना में सात डेटा सरणियाँ हैं:

• sOpen , sHigh , sLow , sClose , sVol , sOI , sInd ,

MSXDataInfoRec संरचना में उनके मूल्यों को संग्रहीत करना। ये डेटा सेट सेंट्रल बैंक के सभी आवश्यक मूल्य डेटा को स्टोर करते हैं।

यदि केंद्रीय बैंक के पास इस मूल्य क्षेत्र (उदाहरण के लिए, ओपन इंटरेस्ट) के लिए डेटा नहीं है, तो इनमें से कुछ सरणियाँ खाली हो सकती हैं।

• इसके अलावा, MSXDataRec संरचना में MSXDateTime संरचना से सरणी के लिए एक सूचक होता है।

इस सरणी में प्रत्येक डेटा बिंदु के लिए दिनांक और समय की जानकारी है। यदि गणना फ़ंक्शन को साधन के Nth बार के लिए दिनांक और समय तक पहुंच की आवश्यकता है, तो आपको psDate सरणी के Nth तत्व को संदर्भित करना होगा। कृपया ध्यान दें कि यह सरणी डेटा सरणी जैसे sHigh, sLow, आदि से अलग है।

• sInd data array में यूजर द्वारा चुने गए इंडिकेटर के लिए डेटा होता है। कस्टम इंडिकेटर के मामले में, इस डेटा ऐरे में चार्ट ऑब्जेक्ट के लिए वैल्यू होगी जिस पर इंडिकेटर अटैच किया गया था। यदि sInd भाग का चयन नहीं किया जाता है, तो डेटा ऐरे खाली हो जाएगा।

• ध्यान दें कि इन सरणियों में डेटा का स्थान समयावधि के अनुरूप सरणी के प्रत्येक तत्व के Nth तत्व के साथ सिंक्रनाइज़ किया गया है।

• sClose डेटा सरणी में हमेशा डेटा तत्वों की अधिकतम संख्या होती है। अन्य सभी डेटा सेट में तत्वों की संख्या होती है <= sClose.iLastValid।

• sClose डेटासेट में iFirstValid और iLastValid सेटिंग्स बहुत महत्वपूर्ण हैं।

आमतौर पर, इस सरणी में तत्वों की संख्या अन्य मूल्य सरणियों में संग्रहीत डेटा तत्वों की अधिकतम संख्या निर्धारित करती है। यह PsDate सरणी में निहित वैध तत्वों की संख्या निर्धारित करने के लिए महत्वपूर्ण है। उदाहरण के लिए, यदि sClose.iFirstValid = 100 फ़ील्ड और sClose.iLastValid = 200 फ़ील्ड, तो आप सुनिश्चित कर सकते हैं कि psDate सरणी में psDate [100] और psDate [200] के बीच वैध डेटा है।

• गणना पूर्ण होने के बाद, i_astResalid_psResult -> psResultArray में sClose डेटा सरणी के iLastValid मान से अधिक कभी नहीं होना चाहिए।

• सभी सरणी डेटा को संग्रहीत करने के लिए कितने मान उपलब्ध हैं, यह निर्धारित करने के लिए sClose से iFirstValid और iLastValid का उपयोग किया जाना चाहिए। पर्याप्त मेमोरी सभी सरणियों को संग्रहीत करने के लिए आवंटित की गई है, केवल sClose.iLastValid डेटा बिंदु पर। डेटा a_psResult -> psResultArray से MSX DLL से वापस उसी स्टोरेज प्रतिबंध में फिट होना चाहिए।

• a_psResult-> psResultArray डेटासेट की शुरुआत MSX DLL से लौटकर कभी भी sClose.iFirstValid से कम नहीं होनी चाहिए। डेटा का अंत सेट a_psResult -> psResultArray कभी भी sClose.iLastValid से अधिक नहीं होना चाहिए।

जिसे आपको याद रखने की आवश्यकता है

• गणना कार्यों को कभी भी आने वाले तर्कों को नहीं बदलना चाहिए, परिणामस्वरूप रिकॉर्ड (a_psResult) को छोड़कर। इनकमिंग तर्कों को ' कॉन्स्ट ' के रूप में परिभाषित किया गया है, जहाँ संभव हो, प्रदान किए गए टेम्प्लेट में यह सुनिश्चित करने के लिए कि कोई भी अवैध परिवर्तन न हो।

• अपने कार्य से लौटने से पहले a_psResult -> psResultArray -> iFirstValid और a_psResult -> psResultArray -> iLastValid सेट करना सुनिश्चित करें।

• यदि आपका फ़ंक्शन MSX_ERROR लौटाता है, जो एक आंतरिक त्रुटि को इंगित करता है, तो त्रुटि को a_psResult -> pszExtendedError विस्तारित स्ट्रिंग में वर्णन करते हुए त्रुटि की प्रतिलिपि बनाना सुनिश्चित करें।

• a_psResult -> psResultArray -> iFirstValid को sClose.iFirstValid से कम सेट न करें।

• a_psResult -> psResultArray -> iLastValid को sClose.iLastValid से अधिक सेट न करें। A_psResult -> psResultArray -> pfValue को मान sClose.iLastValid पर लिखने से मेमोरी MetaStock में मैप हो जाएगी और क्रैश होने का प्रोग्राम हो जाएगा।

• किसी भी MSXDataInfoRec या a_psBasic तर्कों का उपयोग करने के लिए iFirstValid और iLastValid की जाँच करना सुनिश्चित करें जिन्हें आप उपयोग करना चाहते हैं। यह कभी न सोचें कि डेटा किसी भी डेटा ऐरे में उपलब्ध होगा। यदि डेटा आपके प्रोसेसिंग फ़ंक्शन के लिए उपलब्ध नहीं है, तो सेट करें

a_psResult -> psResultArray -> iFirstValid = 0 और

a_psResult -> psResultArray -> iLastValid = -1 ,

यह इंगित करने के लिए कि सरणी वापस करने के लिए कोई मान्य डेटा नहीं है। यह विधि मेटास्टॉक कार्यक्रम की असामान्य समाप्ति से बचती है।

कोड बदलें

उपरोक्त सामग्री के अनुसार, हम अपने फ़ंक्शन के कोड को थोड़ा संशोधित करेंगे। हमारे फ़ंक्शन के आउटपुट पर क्षतिग्रस्त सरणी प्राप्त करने के मामले में Fvi और Lvi, साथ ही एक अपवाद जोड़ें।

 DLL_EXPORT BOOL __stdcall Price(const MSXDataRec *a_psBasic, const MSXDataInfoRecArgsArray *a_psArrayArgs, const MSXNumericArgsArray *a_psNumericArgs, const MSXStringArgsArray *a_psStringArgs, const MSXCustomArgsArray *a_psCustomArgs, MSXResultRec *a_psResult) { BOOL l_bRtrn = MSX_SUCCESS; for (int i= a_psBasic ->sClose.iFirstValid; i<= a_psBasic ->sClose.iLastValid; i++) a_psResult->psResultArray->pfValue[ i ] = a_psBasic ->sClose.pfValue[ i ]; //     . a_psResult->psResultArray->iFirstValid = a_psBasic->sClose.iFirstValid; a_psResult->psResultArray->iLastValid = a_psBasic->sClose.iLastValid; //    if (a_psResult->psResultArray->iFirstValid < 0 || a_psResult->psResultArray->iLastValid < 0 || a_psResult->psResultArray->iLastValid < a_psResult->psResultArray->iFirstValid || a_psResult->psResultArray->iFirstValid < a_psBasic->sClose.iFirstValid || a_psResult->psResultArray->iLastValid > a_psBasic->sClose.iLastValid) l_bRtrn = MSX_ERROR; //    ,   . if (l_bRtrn != MSX_SUCCESS) { strncpy (a_psResult->szExtendedError, "Error: Corrupted Result Array.", sizeof(a_psResult->szExtendedError)-1); a_psResult->psResultArray->iFirstValid = 0; a_psResult->psResultArray->iLastValid = -1; } return l_bRtrn; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

फाइल करने के लिए आउटपुट

हमारे डेटा को प्रदर्शित करने के लिए, stdio.h हेडर फ़ाइल को शामिल करना सुनिश्चित करें, जिसमें एक विशेष डेटा प्रकार घोषित किया गया है - फ़ाइल संरचना।

• <ainclude <stdio.h>



चलिए निम्नलिखित डेटा प्राप्त करते हैं: सेंट्रल बैंक का नाम, अवधि ('डी', 'W'eekly,' M'onthly, 'Q'uarterly,' llntraday), इंडेक्स, हमारे संकेतक, फ़ाइल में समय और दिनांक।

 DLL_EXPORT BOOL __stdcall Price(const MSXDataRec *a_psBasic, const MSXDataInfoRecArgsArray *a_psArrayArgs, const MSXNumericArgsArray *a_psNumericArgs, const MSXStringArgsArray *a_psStringArgs, const MSXCustomArgsArray *a_psCustomArgs, MSXResultRec *a_psResult) { BOOL l_bRtrn = MSX_SUCCESS; FILE *file; file = fopen("D:\\example.txt", "w"); for (int i= a_psBasic ->sClose.iFirstValid; i<= a_psBasic ->sClose.iLastValid; i++) { a_psResult->psResultArray->pfValue[ i ] = a_psBasic ->sClose.pfValue[ i ]; if (file) fprintf(file, "%-10s %2c %5u %12.4f %5u %10u\n", a_psBasic ->pszSecurityName, a_psBasic ->iPeriod, i, double (a_psResult->psResultArray->pfValue[i]), a_psBasic ->psDate[i].lTime/1000, a_psBasic ->psDate[i].lDate); } fclose(file); //     . a_psResult->psResultArray->iFirstValid = a_psBasic->sClose.iFirstValid; a_psResult->psResultArray->iLastValid = a_psBasic->sClose.iLastValid; //    if (a_psResult->psResultArray->iFirstValid < 0 || a_psResult->psResultArray->iLastValid < 0 || a_psResult->psResultArray->iLastValid < a_psResult->psResultArray->iFirstValid || a_psResult->psResultArray->iFirstValid < a_psBasic->sClose.iFirstValid || a_psResult->psResultArray->iLastValid > a_psBasic->sClose.iLastValid) l_bRtrn = MSX_ERROR; //    ,   . if (l_bRtrn != MSX_SUCCESS) { strncpy (a_psResult->szExtendedError, "Error: Corrupted Result Array.", sizeof(a_psResult->szExtendedError)-1); a_psResult->psResultArray->iFirstValid = 0; a_psResult->psResultArray->iLastValid = -1; } return l_bRtrn; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

परिणामस्वरूप, मुझे आरटीएस सूचकांक पर वायदा के एक मिनट के चार्ट पर निम्नलिखित मिला:



बिना तर्क के कार्यों के साथ, मुझे आशा है कि हमने इसे समझ लिया है। अगले लेख में, हम विभिन्न तर्कों के साथ कार्यों का निर्माण करेंगे।