Функциональный блок FS_WRITE
Функциональный блок FS_WRITE записывает данные в файл.
Внимание: Существующие файлы будут перезаписаны без предупреждения.
Файловая система должна быть предварительно инициализирована с помощью FS_INIT. Все операции выполняются асинхронно для каждого созданного носителя.
Вход WRITE
При положительном фронте данные записываются на носитель.
Вход DEV
Определяет устройство, с которого следует получить доступ к файлам. Устройство используется в проекте и может быть управляемо в контекстном меню под Проект Внешнее хранилище.
Вход PATH
Указывает путь к файлу на носителе. Путь соответствует пути к файлу Unix в формате UTF-8, если это поддерживается. Путь представлен следующим образом:
Папка/Подпапка/Файл.txt
Вход DATA
Определяет данные, которые должны быть записаны.
Вход MODE
Указывает режим, в котором файл должен быть записан. Возможные режимы:
| Режим | Описание |
|---|---|
| "r" | Открыт только для чтения. Устанавливает указатель файла в начало файла. |
| "r+" | Открыт только для чтения и записи. Устанавливает указатель файла в начало файла. |
| "w" | Открыт только для записи. Устанавливает указатель файла в начало файла. Удаляет содержимое файла. Если файл не существует, он создается. |
| "w+" | Открыт только для записи и чтения. Устанавливает указатель файла в начало файла. Удаляет содержимое файла. Если файл не существует, он создается. |
| "a" | Открыт только для записи. Устанавливает указатель файла в конец файла. Если файл не существует, он создается. Данные добавляются в конец. |
| "a+" | Открыт только для записи и чтения. Устанавливает указатель файла в конец файла. Если файл не существует, он создается. Данные добавляются в конец. |
| "x" | Открыт только для записи. Устанавливает указатель файла в начало файла. Если файл существует, операция прерывается. |
| "x+" | Открыт только для записи и чтения. Устанавливает указатель файла в начало файла. Если файл существует, операция прерывается. |
| "c" | Открыт только для записи. Устанавливает указатель файла в начало файла. Если файл не существует, он создается. Перезаписывает содержимое файла. |
| "c+" | Открыт только для записи и чтения. Устанавливает указатель файла в начало файла. Если файл не существует, он создается. Перезаписывает содержимое файла. |
Вход BOM
Если вход при записи истинен, то UTF-8 Byte Order Mark добавляется в начало файла. Это происходит только если файл перезаписывается или создается заново. Если BOM не был записан в начале файла, его нельзя добавить позже.
Выход DONE
Выход возвращает импульс при успехе, чтобы выполнить следующую операцию. Импольс происходит по завершении операции, даже если произошла ошибка.
Выход LENGTH
Возвращает количество записанных байтов. Состояние сохраняется для последующего использования.
Выход ERROR
В случае ошибки возвращает текст с сообщением об ошибке. Он FALSE, если ошибка не возникла. Состояние сохраняется для последующего использования.
Возможные причины:
- Сервис носителя не был запущен.
- Хранилище не было инициализировано.
- Данные для входа недействительны.
- Удаленный сервер недоступен.
- Носитель не существует.
- Указанный путь недействителен.
- На носитель нельзя записывать.
- Нет места на носителе или носитель защищен от записи.