Moves the file pointer in a file opened with a low-level file function.
FSEEK(nFileHandle, nBytesMoved [, nRelativePosition])
- Specifies the file handle for the file in which FSEEK(В ) moves the file pointer. A file handle number is returned by FCREATE(В ) or FOPEN(В ) when the file is created or opened.
- Specifies the number of bytes to move the file pointer. The file pointer is moved toward the end of the file if nBytesMoved is positive. The file pointer is moved toward the beginning of the file if nBytesMoved is negative.
Moves the file pointer to a relative position in the file. By default, the file pointer is moved relative to the beginning of the file. You can also move the file pointer relative to the current file pointer or the end of the file by including nRelativePosition. The following table lists values for nRelativePosition and from where the file pointer is moved.
nRelativePosition Moves the file pointer relative to
(Default) The beginning of the file.
The current file pointer position.
The end of the file.
After moving the file pointer, FSEEK(В ) returns the number of bytes the file pointer is positioned from the beginning of the file. The file pointer can also be moved with FREAD(В ) and FWRITE(В ).
The following user-defined function uses FSEEK(В ) to return the size of a file. If you don't pass parameters to the user-defined function, it returns вЂ“2. If the file cannot be found, the user-defined function returns вЂ“1.
FUNCTION fsize2 PARAMETERS gcFileName && File to be checked PRIVATE pnHandle,pnSize IF PARAMETERS( ) = 0 RETURN -2 && Return -2 if no parameter passed ELSE IF !FILE(gcFileName) RETURN -1 && Return -1 if file does not exist ENDIF ENDIF pnHandle = FOPEN(gcFileName) && Open file pnSize = FSEEK(pnHandle,0,2) && Determine file size, assign to pnSize =FCLOSE(pnHandle) && Close file RETURN pnSize && Return value