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().

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

$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().