كتلة الوظيفة FS_READLINE

تقرأ كتلة الوظيفة FS_READLINE البيانات سطرًا سطرًا من ملف.

تحذير: عند قراءة الملفات الكبيرة جدًا قد تتعطل PLC أو النظام بالكامل ولا يمكن تشغيله مرة أخرى.

ملاحظة: يبلغ الحد الأقصى لحجم السطر القابل للقراءة لأسباب أمنية 1024'000 بايت.

يجب أن يتم تهيئة نظام الملفات مسبقًا باستخدام FS_INIT. تحدث جميع العمليات بشكل غير متزامن لكل وسائط تخزين تم إنشاؤها.

مدخل READ

عند حافة إيجابية، يتم قراءة البيانات من وسائط التخزين.

مدخل DEV

يحدد الجهاز الذي سيتم الوصول إليه من خلاله إلى الملفات. يتم استخدام الجهاز لكل مشروع ويمكن إدارته في قائمة السياق تحت المشروع ▸ التخزين الخارجي.

مدخل PATH

يحدد المسار إلى الملف على وسائط التخزين. يتوافق المسار مع مسار ملف Unix في تنسيق 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 Byte Order Mark، يكون المخرج صحيحًا. يتم تحديد BOM في كل عملية قراءة.

مخرج ERROR

في حالة الخطأ، يعيد نصًا مع رسالة خطأ. وهو FALSE إذا لم يحدث أي خطأ. يتم تخزين الحالة للاستخدام اللاحق.

السبب المحتمل:

  • لم يتم تشغيل خدمة وسائط التخزين.
  • لم يتم تهيئة الذاكرة.
  • بيانات تسجيل الدخول غير صالحة.
  • لم يمكن الوصول إلى الخادم البعيد.
  • وسائط التخزين لا موجودة.
  • المسار المحدد غير صالح.