Метод .setdata
| Назначение: | Записывает данные в файл, открытый «на» выбранном в данный момент номере файла (выбор выполняется через fd.filenum). Данные записываются начиная с позиции fd.pointer. |
| Синтаксис: | fd.setdata(byref data as string) as pl_fd_status_codes |
| Возвращает: | Один из следующих pl_fd_status_codes; значение также влияет на fd.laststatus: 0 - PL_FD_STATUS_OK: выполнено успешно. 1 - PL_FD_STATUS_FAIL : сбой физической флеш-памяти (критический). 2 - PL_FD_STATUS_CHECKSUM_ERR: в одном из секторов диска обнаружена ошибка контрольной суммы (критическая). 3 - PL_FD_STATUS_FORMAT_ERR: обнаружена ошибка форматирования диска (критическая). 7 - PL_FD_STATUS_DATA_FULL: диск заполнен, новые данные добавить нельзя. 8 - PL_FD_STATUS_NOT_READY: диск не смонтирован. 10 - PL_FD_STATUS_NOT_OPENED: на текущем значении свойства fd.filenum не открыт ни один файл. 14 - PL_FD_STATUS_TRANSACTION_CAPACITY_EXCEEDED: в ходе текущей транзакции изменено слишком много секторов диска (критическая ошибка). |
| См. также: | Запись в файлы и чтение из файлов, fd.getdata, fd.pointer, fd.setpointer, fd.filesize |
| Часть | Описание |
| data | Строка с данными, записываемыми в файл. Если диск заполнится, данные не будут записаны вовсе (а не только та часть, которая не поместилась). |
Подробности
В результате вызова метода указатель сдвигается вперёд на число байт, фактически записанных в файл.
Метод изменяет секторы флеш-диска. Для максимальной надёжности вызывайте его в рамках дисковых транзакций.