بلوک عملکرد FS_READLINE

بلوک عملکرد FS_READLINE داده‌ها را خط به خط از یک فایل می‌خواند.

توجه: هنگام خواندن فایل‌های بسیار بزرگ، کنترلگر منطقی برنامه نویسی شده یا کل سیستم ممکن است خراب شود و دیگر راه اندازی نشود.

نکته: اندازه حداکثر قابل خواندن یک خط به دلایل امنیتی 1024'000 بایت است.

سیستم فایل باید قبلاً با استفاده از FS_INIT اولیه شده باشد. تمام عملیات‌ها به صورت غیر همزمان برای هر دستگاه ذخیره‌سازی ایجاد شده انجام می‌شوند.

ورودی READ

در یک لبه مثبت، داده‌ها از دستگاه ذخیره‌سازی خوانده می‌شوند.

ورودی DEV

دستگاه را تعریف می‌کند که باید به فایل‌ها دسترسی داشته باشد. دستگاه برای هر پروژه استفاده می‌شود و می‌تواند در منوی کنTEXT تحت پروژه ▸ ذخیره‌سازی خارجی مدیریت شود.

ورودی PATH

مسیر فایل در دستگاه ذخیره‌سازی را مشخص می‌کند. مسیر به یک مسیر فایل Unix در فرمت UTF-8 مطابقت دارد، اگر این مورد پشتیبانی شود. مسیر به صورت زیر نمایش داده می‌شود:

پوشه/زیرپوشه/فایل.txt

ورودی LINE

خطی را که باید خوانده شود تعریف می‌کند. خط اول با شماره 0 شروع می‌شود.

ورودی ENDING

پایان خط را تعریف می‌کند. این با اسکیپ‌ها مشخص می‌شود: "\r\n". اگر ورودی تعریف نشده باشد، "\n" فرض می‌شود.

در موارد زیر escape در نظر گرفته می‌شود:

• "\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 است اگر خطایی رخ نداده باشد. وضعیت برای استفاده بعد ذخیره می‌شود.

دلیل‌های ممکن:

• خدمت دستگاه ذخیره‌سازی راه اندازی نشده است.
• ذخیره‌سازی اولیه نشده است.
• اطلاعات ورود نامعتبر است.
• سرور دور نمی‌تواند به دست آید.
• دستگاه ذخیره‌سازی وجود ندارد.
• مسیر مشخص شده نامعتبر است.