.setpointer Method


Sets the new pointer position for a file opened "on" a currently selected file number (selection is made through fd.filenum).


fd.setpointer(pos as dword) as pl_fd_status_codes


One of the following pl_fd_status_codes, also affects fd.laststatus:

0 — PL_FD_STATUS_OK: Completed successfully.

1 — PL_FD_STATUS_FAIL : Physical flash memory failure (fatal).

2 — PL_FD_STATUS_CHECKSUM_ERR: Checksum error has been detected in one of the disk sectors (fatal).

3 — PL_FD_STATUS_FORMAT_ERR: Disk formatting error has been detected (fatal).

8 — PL_FD_STATUS_NOT_READY: The disk is not mounted.

See Also:

Writing To and Reading From Files, fd.getdata, fd.setdata, fd.pointer, fd.filesize




Desired new pointer position. The supplied value will be corrected if out of range. For the files of 0 size (see fd.filesize), the pointer may only have one value — 0. If the file has non-zero size, the pointer can be between 1 and fd.filesize + 1. "1" is the position of the first byte of the file. The last existing byte of the file is at position equal to the value of fd.filesize. "fd.filesize + 1" is the position at which new data can be added to the file.