fgets

(PHP 3, PHP 4 >= 4.0.0)

fgets -- Pobiera linię ze wskaźnika pliku

Opis

string fgets ( int fp [, int długość])

Zwraca łańcuch o długości - 1 bajtów odczytany z pliku wskazanego przez fp. Czytanie kończy się kiedy przeczytano długość - 1 bajtów lub gdy wystąpi znak nowej linii (jest on dołączany do zwracanego wyniku) lub gdy wystąpi znak końca pliku EOF (którykolwiek przypadek zdarzy się pierwszy). Jeśli nie została określona długość, domyślnie przyjmuje 1k (1024 bajty).

W przypadku błędu, zwraca FALSE.

Główna pułapka:

Osoby używające semantyki 'C' z fgets powinni zauważyć różnicę w sposobie zwracania EOF.

Wskaźnik pliku musi być poprawny i musi wskazywać na plik poprawnie otwarty przez fopen(), popen() lub fsockopen().

Prosty przykład:

Przykład 1. Czytanie pliku linia po linii

$fd = fopen ("/tmp/inputfile.txt", "r");
while (!feof ($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
}
fclose ($fd);

Patrz także fread(), fopen(), popen(), fgetc(), fsockopen() i socket_set_timeout().