Сканкод · дистрибьютор в РФ и СНГБаза знаний / Справочник TiOS / Разработка (TiOS) / Справочник по программированию / Объекты / Объект fd. / Свойства и методы
Метод .setpointer
| Назначение: | Задаёт новую позицию указателя для файла, открытого «на» выбранном в данный момент номере файла (выбор выполняется через fd.filenum). |
| Синтаксис: | fd.setpointer(pos as dword) 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: обнаружена ошибка форматирования диска (критическая). 8 - PL_FD_STATUS_NOT_READY: диск не смонтирован. |
| См. также: | Запись в файлы и чтение из файлов, fd.getdata, fd.setdata, fd.pointer, fd.filesize |
| Часть | Описание |
| pos | Желаемая новая позиция указателя. Если переданное значение выходит за допустимый диапазон, оно корректируется. Для файлов нулевого размера (см. fd.filesize) указатель может иметь только одно значение - 0. Если размер файла не нулевой, указатель может находиться между 1 и fd.filesize + 1. «1» - позиция первого байта файла. Последний существующий байт файла находится в позиции, равной значению fd.filesize. «fd.filesize + 1» - позиция, в которую можно добавить новые данные. |