بلوک عملکرد FS_READ
بلوک عملکرد FS_READ دادهها را از یک فایل میخواند.
توجه: هنگام خواندن فایلهای بسیار بزرگ، کنترلگر منطقی برنامه نویسی شده یا کل سیستم ممکن است خراب شود و دیگر راه اندازی نشود. فقط با احتیاط از ورودی LENGTH=0 استفاده کنید.
سistema de archivos debe haber sido inicializado previamente mediante FS_INIT. Todas las operaciones se realizan de forma asíncrona por cada medio de almacenamiento creado.
ورودی READ
در یک لبه مثبت، دادهها از دستگاه ذخیرهسازی خوانده میشوند.
ورودی DEV
دستگاه را تعریف میکند که باید از آن برای دسترسی به فایلها استفاده شود. دستگاه در پروژه استفاده میشود و میتواند در منوی کنTEXT تحت پروژه ذخیرهسازی خارجی مدیریت شود.
ورودی PATH
مسیر فایل در دستگاه ذخیرهسازی را مشخص میکند. مسیر به یک مسیر فایل Unix در فرمت UTF-8 مطابقت دارد، اگر این مورد پشتیبانی شود. مسیر به صورت زیر نمایش داده میشود:
پوشه/زیرپوشه/فایل.txt
ورودی OFFSET
Offset را در بایتها تعریف میکند که باید از آن خوانده شود. اگر Offset تعریف نشده باشد، از آغاز فایل خوانده میشود.
ورودی LENGTH
حداکثر طول را تعریف میکند تا خواندن متوقف شود. اگر ورودی تعریف نشده باشد، تا پایان فایل خوانده میشود.
توضیحات: حداکثر اندازه قابل خواندن در LENGTH=0 به دلیل دلایل امنیتی 1024'000 بایت است.
خروجی DONE
خروجی در صورت موفقیت یک پالس برمیگرداند تا عملیات بعدی انجام شود. پالس هنگام پایان فرایند، حتی اگر خطا رخ داده باشد، اتفاق میافتد.
خروجی DATA
دادههای خوانده شده را برمیگرداند. وضعیت برای استفاده بعد ذخیره میشود.
خروجی EOF
اگر پایان فایل به دست آمده باشد، ورودی درست است.
خروجی BOM
اگر UTF-8 Byte Order Mark پیدا شده باشد، خروجی درست است. BOM در هر فرایند خواندن تعیین میشود.
خروجی ERROR
در صورت خطا یک متن با پیام خطا را برمیگرداند. این FALSE است اگر خطایی رخ نداده باشد. وضعیت برای استفاده بعد ذخیره میشود.
دلیلهای ممکن:
- خدمت دستگاه ذخیرهسازی راه اندازی نشده است.
- ذخیرهسازی اولیه نشده است.
- اطلاعات ورود نامعتبر است.
- سرور دور نمیتواند به دست آید.
- دستگاه ذخیرهسازی وجود ندارد.
- مسیر مشخص شده نامعتبر است.