fgets

(PHP 3, PHP 4)

fgets - получает строку из указателя на файл.

Описание

string fgets (int fp [, int length])

Возвращает строку размером длина строки - 1 байт, прочитанную из файла, на который указывает fp. Чтение заканчивается при достижении точки length - 1 байт, символа newline (который включается в return-значение) или EOF (смотря что будет найдено первым). Если length не специфицирован, по умолчанию length будет 1k, или 1024 байт.

Если возникла ошибка, возвращает FALSE.

Обычные недочёты:

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

Указатель на файл обязан быть правильным и указывать на файл, успешно открытый функциями fopen(), popen() или fsockopen().

Вот простой пример:

Пример 1. Построчное чтение файла $fd = fopen ("/tmp/inputfile.txt", "r"); while (!feof ($fd)) { $buffer = fgets($fd, 4096); echo $buffer; } fclose ($fd);

Примечание: параметр length стал необязательным в PHP 4.2.0.

См. также fread(), fopen(), popen(), fgetc(), fsockopen() и socket_set_timeout().