HIVE hosting - PHP: fgets

Руководство по PHP
Пред.		След.

Описание

строка fgets ( ресурс дескриптор [, целое длина])

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

В случае возникновения ошибки функция возвращает FALSE.

Наиболее распространенные ошибки:

Программисты, привыкшие к семантике 'C' функции fgets(), должны принимать во внимание разницу в том, каким образом возвращается признак достижения конца файла (EOF).

Дескриптор должен указывать на файл, открытый ранее с помощью функции fopen(), popen() или fsockopen().

Ниже приведен простой пример:
Пример 1. Построчное чтение файла
<?php $handle = fopen ("/tmp/inputfile.txt", "r"); while (!feof ($handle)) { $buffer = fgets($handle, 4096); echo $buffer; } fclose ($handle); ?>

Замечание: Параметр длина стал необязательным, начиная с PHP версии 4.2.0. Если этот параметр опущен, длина строки принимается за 1024. С версии PHP 4.3, опускание параметра length будет приводить к чтению потока до конца строки. Если длина большинства строк в файле превышает 8 килобайт, наиболее эффективным решением в отношении ресурсов, используемых скриптом, будет указание максимальной длины строки.

Замечание: Данная функция может корректно обрабатывать двоичные данные, начиная с версии PHP 4.3. Более ранние версии не обладали этой функциональностью.

Замечание: Если у вас возникают проблемы с распознаванием PHP окончания строк при чтении файлов на Macintosh-совместимом компьютере или при чтении файлов, созданных на Macintosh-совместимом компьютере, необходимо включить опцию auto_detect_line_endings.

См.также описание функций fread(), fgetc(), stream_get_line(), fopen(), popen(), fsockopen() и socket_set_timeout().

Пред.	Начало	След.
fgetcsv	Уровень выше	fgetss