Zwraca Å‚aÅ„cuch o dÅ‚ugość - 1 bajtów odczytany z pliku wskazanego przez uchwyt . 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ść, bÄ™dzie nastÄ™powaÅ‚o czytanie ze strumienia dopóki nie zostanie osišgniÄ™ty koniec linii.
W przypadku błędu, zwraca FALSE.
GÅ‚ówna puÅ‚apka:
Osoby przyzwyczajone do semantyki 'C' powinni zauważyć różnicÄ™ w sposobie zwracania EOF przez fgets().
Wskaźnik na plik musi być poprawny i musi wskazywać na plik pomyślnie otwarty przez funkcję fopen() lub fsockopen() (a jednocześnie nie zamknięty jeszcze przez fclose()).
Informacja: Parametr długość stał się opcjonalny w PHP 4.2.0 jeśli został pominięty, to powinien przyjąć wartość 1024. Jeśli większość lini w pliku jest dłuższa od 8KB, dużo efektywniejsze jest podanie maksymalnej długości linii.
Informacja: Funkcja jest binaarnie bezpieczna od PHP 4.3. Poprzednie wersje nie sÄ… binarnie bezpieczne.
Informacja: JeÅ›li PHP niewÅ‚aÅ›ciwie rozpoznaje znaki koÅ„ca linii podczas odczytu plików stworzonych lub znajdujÄ…cych siÄ™ na komputerach Macintosh, problem może rozwiÄ…zać włączenie dyrektywy konfiguracyjnej auto_detect_line_endings .
Kompatybilność: PHP4, PHP5.
Listing
$uchwyt = @fopen ("/tmp/inputfile.txt", "r");
if ($uchwyt) {
while (!feof($uchwyt)) {
$buffer = fgets($uchwyt, 4096);
echo $buffer;
}
fclose ($uchwyt);
}
?>
Ranga: Administrator serwisu Punktów: 38473

