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

FGETS(nFileHandle [, nBytes])

Параметры

nFileHandle

Определяет числовой дескриптор файла или коммуникационного порта из которых FGETS( ) возвращает данные.
nBytes

Определяет количество байтов, которое возвращает FGETS( ) . FGETS( ) возвращает nBytes байтов, до тех пор пока не достигается перевод каретки. FGETS( ) возвращает данные между начальным указателем в файле и символом перевода каретки, в случае, если перевод каретки достигается в пределах nBytes байтов. FGETS( ) возвращает максимум 8192 байтов. Если Вы опускаете 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

См. Также