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