.Setpointer Method

Top  Previous  Next

Function:

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

Syntax:

fd.setpointer(pos as dword) as pl_fd_status_codes

Returns:

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

 


Part

Description

pos

Desired new pointer position. 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.

Details

---