फंक्शन ब्लॉक FS_READLINE

फंक्शन ब्लॉक FS_READLINE एक फ़ाइल से डेटा लाइन द्वारा पढ़ता है।

सावधान: बहुत बड़े फ़ाइलों को पढ़ने पर SPS या पूरे सिस्टम क्रैश हो सकता है और फिर से शुरू नहीं हो सकता।

हिन्ट: सुरक्षा कारणों से एक लाइन का अधिकतम पठनीय आकार 1024'000 बाइट्स है।

फ़ाइल सिस्टम को पहले FS_INIT के माध्यम से इनिशियलाइज़ किया जाना चाहिए। सभी ऑपरेशन हर बनाए गए स्टोरेज मीडिया के लिए एसिंक्रोनस रूप से होते हैं।

इनपुट READ

एक पॉजिटिव एज पर, डेटा स्टोरेज मीडिया से पढ़ा जाता है।

इनपुट DEV

यह फ़ाइलों तक पहुंचने के लिए उपयोग की जाने वाली डिवाइस को परिभाषित करता है। डिवाइस हर प्रोजेक्ट के लिए उपयोग किया जाता है और इसे प्रोजेक्ट ▸ एक्सटर्नल स्टोरेज के तहत कॉन्टेक्स्ट मेनू में प्रबंधित किया जा सकता है।

इनपुट PATH

यह स्टोरेज मीडिया पर फ़ाइल तक का पथ देता है। पथ एक यूनिक्स फ़ाइल पथ के समान होता है, अगर यह सपोर्ट किया जाता है तो UTF-8 फॉर्मेट में। पथ इस प्रकार प्रदर्शित किया जाता है:

फोल्डर/सबफोल्डर/फ़ाइल.txt

इनपुट LINE

यह उस लाइन को परिभाषित करता है जिसे पढ़ना है। पहला लाइन नंबर 0 से शुरू होता है।

इनपुट ENDING

यह लाइन ब्रेक को परिभाषित करता है। यह एस्केप्स के साथ दिया जाता है: "\r\n". अगर इनपुट को परिभाषित नहीं किया गया है, तो "\n" माना जाता है।

निम्नलिखित चिह्नों के लिए एस्केप का ध्यान रखा जाता है:

• "\t" (ASCII 9 (0x09)), एक टैब चिह्न।
• "\n" (ASCII 10 (0x0A)), एक लाइन फीड (Line Feed)।
• "\r" (ASCII 13 (0x0D)), एक कैरेज रिटर्न चिह्न (Carriage Return)。
• "\0" (ASCII 0 (0x00)), NUL बाइट।
• '\xEF' बाइट्स के लिए लिखने का रूप।

हिन्ट: ताकि बाइनरी चिह्न, जैसे कि '\xEF', परिभाषित किए जा सकें, उन्हें सिंगल क्वोटेशन मार्क्स में परिभाषित किया जाना चाहिए।

आउटपुट DONE

आउटपुट सफलता के मामले में अगले ऑपरेशन को करने के लिए एक पल्स देता है। पल्स प्रक्रिया समाप्त होने पर होता है, भले ही कोई त्रुटि हुई हो।

आउटपुट DATA

यह पढ़ी गई लाइन, जिसमें लाइन एंड भी शामिल है, वापस देता है। स्थिति बाद के उपयोग के लिए संग्रहीत की जाती है।

आउटपुट EOF

अगर फ़ाइल का अंत पहुंच गया है, तो इनपुट सत्य है।

आउटपुट BOM

अगर UTF-8 बाइट ऑर्डर मार्क पाया गया है, तो आउटपुट सत्य है। BOM हर पढ़ने की प्रक्रिया में निर्धारित किया जाता है।

आउटपुट ERROR

त्रुटि के मामले में यह एक त्रुटि संदेश के साथ टेक्स्ट वापस देता है। यह FALSE होता है अगर कोई त्रुटि नहीं हुई है। स्थिति बाद के उपयोग के लिए संग्रहीत की जाती है।

संभावित कारण:

• स्टोरेज मीडिया का सर्विस शुरू नहीं किया गया था।
• स्टोरेज को इनिशियलाइज़ नहीं किया गया था।
• लॉगिन डेटा अमान्य हैं।
• रिमोट सर्वर तक पहुंचा नहीं जा सका।
• स्टोरेज मीडिया मौजूद नहीं है।
• दिया गया पथ अमान्य है।