Перемещает указатель файла (pointer), открытого низкоуровневой файловой функцией.

FSEEK(nFileHandle, nBytesMoved [, nRelativePosition])

Параметры

nFileHandle

Определяет дескриптор файла (handle), для которого необходимо переместить указатель функцией FSEEK( ). Номер дескриптора файла возвращается функциями  FCREATE( ) или FOPEN( ), когда файл открывается .

nBytesMoved

Определяет количество байт для перемещения указателя. Указатель премещается вперед, если значение параметра nBytesMoved положительно. Если значение параметра nBytesMoved отрицательное, то указатель перемещается назад, к началу файла.

nRelativePosition

Определяет отправную точку отсчета перемещения указателя в файле. По-умолчанию, указатель перемещается от начала файла. Вы можете задавать перемещение указателя файла относительно его текущей позиции или относительно конца файла. Для этого используется параметр nRelativePosition. Следующий список определяет возможные значения данного параметра nRelativePosition для перемещения указателя файла.

nRelativePosition Перемещение указателя относительно

0

(по-умолчанию) начала файла.

1

текущей позиции указателя (pointer).

2

Конца файла.

Expand imageВозвращаемое Значение

Значение типа Numeric

Expand imageКомментарии

После перемещения указателя файла, функция FSEEK( ) возвращает позицию указателя файла относительно начала файла. Указатель файла может быть перемещен также функциями FREAD( ) и FWRITE( ).

Expand imageПример

В следующем примере представлена пользовательская функция, использующая FSEEK( ) для определения размера файла. Если параметры отсутствуют, то возвращается значение = –2. Если файл не найден, то возвращается значение = –1.

  CopyCode imageКопировать Код
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

Expand imageСм. также