Возвращает последовательность байтов из файла или порта связи, открытого с помощью файловой функции низкого уровня.

Синтаксис:

FGETS(nFileHandle [, nBytes])

Параметры:
nFileHandle
Задает дескриптор файла для файла или порта связи, из которого функция FGETS( ) будет возвращать данные.
nBytes
Задает количество байтов, возвращаемых функцией FGETS( ). Она возвращает заданное число байтов, если только раньше не встретится возврат каретки. FGETS( ) возвращает данные, начиная от исходной позиции указателя файла и кончая символом возврата каретки, если он попадает в число nBytes байтов.
Если аргумент nBytes опущен, FGETS( ) по умолчанию возвращает максимум 254 байта.

Результат:
Символьный.

Комментарии:
Можно читать файл по строкам, выдавая последовательность функций FGETS( ).
FGETS( ) возвращает серию байтов в виде символьной строки. Данные возвращаются, начиная с текущей позиции указателя файла и до тех пор, пока не встретится возврат каретки. После этого указатель файла устанавливается на байт, непосредственно следующий за символом возврата каретки. Сам этот символ не возвращается в составе строки, символы перевода строки также отбрасываются.

Пример:

*** TEST.TXT must exist ***
STORE FOPEN('test.txt') TO gnFileHandle	&& Open the file
STORE FSEEK(gnFileHandle, 0, 2) TO gnEnd	&& Move pointer to EOF
STORE FSEEK(gnFileHandle, 0) TO gnTop	&& Move pointer to BOF
IF gnEnd <= 0		&& Is file empty?
	WAIT WINDOW 'This file is empty!' NOWAIT
ELSE	&& If not
	gcString = FGETS(gnFileHandle, gnEnd)	&& Store contents
	? gcString
ENDIF
= FCLOSE(gnFileHandle)	&& Close the file