PHP fgets() function
Definition and Usage
The fgets() function reads a line from a file pointer.
Syntax
fgets(file,Länge)
Parameter | Description |
---|---|
file | Required. Specifies the file to be read. |
Länge | Optional. Specifies the number of bytes to be read. The default is 1024 bytes. |
Erklärung
von file Zeile aus der Datei lesen und die Länge bis zu Länge - 1 Byte lange Zeichenfolge. Wenn ein Zeilenumbruch (einschließlich im Rückgabewert), EOF oder eine bestimmte Anzahl an Bytes gelesen wurde Länge - 1 Byte abbrechen (je nachdem, was zuerst erreicht wird). Wenn nicht angegeben Länge, dann wird standardmäßig 1K, also 1024 Bytes, voreingestellt.
Fehlschlag führt zu false zurück.
Hinweise und Anmerkungen
Anmerkung:Länge Der Parameter ist ab PHP 4.2.0 optional. Wird ignoriert, wird die Zeilenlänge auf 1024 Bytes vermutet. Ab PHP 4.3 wird ignoriert Länge Fortsetzung des Lesens von Daten aus dem Stream bis zum Zeilenende. Wenn die meisten Zeilen in der Datei größer als 8 KB sind, ist es in der Skriptdatei effizienter, die maximale Zeilenlänge zu spezifizieren.
Anmerkung:Ab PHP 4.3 kann diese Funktion sicher für Binärdateien verwendet werden. Frühere Versionen nicht.
Anmerkung:Wenn PHP beim Lesen der Datei die Zeilenenden des Macintosh-Dateiformats nicht erkennen kann, kann die Laufzeiteinstellung auto_detect_line_endings aktiviert werden.
Beispiel
Beispiel 1
<?php $file = fopen("test.txt","r"); echo fgets($file); fclose($file); ?>
Die Ausgabe ähnelt:
Hallo, dies ist eine Testdatei.
Beispiel 2
<?php $file = fopen("test.txt","r"); while(! feof($file)) { echo fgets($file) . "<br />"; } fclose($file); ?>
Die Ausgabe ähnelt:
Hallo, dies ist eine Testdatei. Hier gibt es drei Zeilen. Dies ist die letzte Zeile.