Функціональний блок FS_READ

Функціональний блок FS_READ читає дані з файлу.

Увага: При читанні дуже великих файлів SPS або вся система можуть вийти з ладу і більше не запускатися. Використовуйте вход LENGTH=0 лише з обережністю.

Файлову систему потрібно спочатку ініціалізувати за допомогою FS_INIT. Всі операції виконуються асинхронно для кожного створеного носія пам'яті.

Вхід READ

При позитивному фронті дані зчитуються з носія пам'яті.

Вхід DEV

Визначає пристрій, з якого потрібно отримувати доступ до файлів. Пристрій використовується для кожного проекту і може бути керований в контекстному меню під Проект ▸ Зовнішня пам'ять.

Вхід PATH

Вказує шлях до файлу на носії пам'яті. Шлях відповідає Unix-шляху до файлу у форматі UTF-8, якщо це підтримується. Шлях представлений наступним чином:

Папка/Підпапка/Файл.txt

Вхід OFFSET

Визначає зсув у байтах, з якого потрібно почати читання. Якщо зсув не визначений, читання починається з початку файлу.

Вхід LENGTH

Визначає максимальну довжину, після якої читання завершується. Якщо вхід не визначений, читання продовжується до кінця файлу.

Примітка: Максимальний розмір для читання при LENGTH=0 становить 1'024'000 байтів за міркуваннями безпеки.

Вихід DONE

При успішному завершенні вихід повертає імпульс, щоб продовжити наступну операцію. Імпульс відбувається при завершенні процесу, навіть якщо сталася помилка.

Вихід DATA

Повертає прочитані дані. Стан зберігається для подальшого використання.

Вихід EOF

Якщо досягнуто кінця файлу, вхід є істинним.

Вихід BOM

Якщо знайдено UTF-8 Byte Order Mark, вихід є істинним. BOM визначається при кожному читанні.

Вихід ERROR

У разі помилки повертає текст з повідомленням про помилку. Він FALSE, якщо помилка не сталася. Стан зберігається для подальшого використання.

Можливі причини:

• Сервіс носія пам'яті не був запущений.
• Пам'ять не була ініціалізована.
• Дані для входу недійсні.
• Віддалений сервер недоступний.
• Носій пам'яті не існує.
• Вказаний шлях недійсний.