.Setfilesize Method

Top  Previous  Next

Function:

Sets (reduces) the file size of a file opened "on" a currently selected file number (selection is made through fd.filenum).

Syntax:

fd.setfilesize(newsize 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.

14- PL_FD_STATUS_TRANSACTION_CAPACITY_EXCEEDED: Too many disk sectors have been modified in the cause of the current transaction (fatal).

See Also:

Removing Data From Files,

fd.cutfromtop

 


Part

Description

newsize

Desired new file size in bytes. Supplied value will be corrected downwards if exceeded previous file size.

Details

As a result of this method invocation, the pointer position may be corrected downwards.

This method makes changes to the sectors of the flash disk. For the highest possible reliability, use disk transactions when invoking this method.