फंक्शन ब्लॉक FS_READ
फंक्शन ब्लॉक FS_READ एक फ़ाइल से डेटा पढ़ता है।
सावधान: बहुत बड़े फ़ाइलों को पढ़ने पर SPS या पूरे सिस्टम क्रैश हो सकता है और फिर से शुरू नहीं हो सकता। केवल सावधानी के साथ इनपुट LENGTH=0 का उपयोग करें।
फ़ाइल सिस्टम को पहले FS_INIT के माध्यम से इनिशियलाइज़ किया जाना चाहिए। सभी ऑपरेशन्स एसिंक्रोनस रूप से हर बनाए गए स्टोरेज मीडिया के लिए होते हैं।
इनपुट READ
एक पॉजिटिव एज पर, डेटा स्टोरेज मीडिया से पढ़ा जाता है।
इनपुट DEV
यह उस डिवाइस को Define करता है, जिससे फ़ाइलों तक पहुंचा जाएगा। डिवाइस को हर प्रोजेक्ट के लिए उपयोग किया जाता है और इसे प्रोजेक्ट एक्सटर्नल स्टोरेज के तहत कॉन्टेक्स्ट मेनू में मैनेज किया जा सकता है।
इनपुट PATH
यह स्टोरेज मीडिया पर फ़ाइल तक की पथ को Specifies करता है। पथ एक Unix फ़ाइल पथ के बराबर होता है, अगर यह सपोर्टेड है तो UTF-8 फॉर्मेट में। पथ इस तरह से प्रदर्शित किया जाता है:
Folder/Subfolder/File.txt
इनपुट OFFSET
यह उस ऑफसेट को Define करता है, जिससे पढ़ना शुरू होना चाहिए। अगर कोई ऑफसेट Define नहीं किया गया है, तो फ़ाइल के शुरुआत से पढ़ा जाएगा।
इनपुट LENGTH
यह उस अधिकतम लंबाई को Define करता है, जब तक कि पढ़ना बंद हो जाता है। अगर इनपुट Define नहीं किया गया है, तो फ़ाइल के अंत तक पढ़ा जाएगा।
नोट: LENGTH=0 पर अधिकतम पठनीय आकार सुरक्षा कारणों से 1024'000 बाइट्स है।
आउटपुट DONE
आउटपुट सफलता पर एक पल्स वापस देता है, ताकि अगला ऑपरेशन किया जा सके। पल्स प्रक्रिया के समापन पर होता है, भले ही कोई त्रुटि हुई हो।
आउटपुट DATA
यह पढ़े गए डेटा वापस देता है। स्थिति को बाद में उपयोग के लिए स्टोर किया जाता है।
आउटपुट EOF
अगर फ़ाइल का अंत पहुंच गया है, तो इनपुट सत्य है।
आउटपुट BOM
अगर UTF-8 बाइट ऑर्डर मार्क पाया गया है, तो आउटपुट सत्य है। BOM हर पढ़ने की प्रक्रिया में निर्धारित किया जाता है।
आउटपुट ERROR
त्रुटि के मामले में, यह एक टेक्स्ट के साथ एक त्रुटि संदेश वापस देता है। यह FALSE होता है, अगर कोई त्रुटि नहीं हुई है। स्थिति को बाद में उपयोग के लिए स्टोर किया जाता है।
संभावित कारण:
- स्टोरेज मीडिया की सेवा शुरू नहीं की गई थी।
- स्टोरेज इनिशियलाइज़ नहीं किया गया था।
- लॉगिन डेटा अमान्य थे।
- रिमोट सर्वर तक पहुंचा नहीं जा सका।
- स्टोरेज मीडिया मौजूद नहीं थी।
- उल्लिखित पथ अमान्य था।