stream_get_line

(PHP 5, PHP 7, PHP 8)

stream_get_lineAkımdan belirtilen ayraca kadar bir satır döndürür

Açıklama

stream_get_line(resource $akım, int $uzunluk, string $ayraç = ""): string|false

Belirtilen akım'dan bir satır döndürür.

uzunluk baytlık veya daha önceyse (boş dizge değilse) ayraç karakterine veya dosya sonuna kadar okunan bayt sayısı uzunlukta bir dizge döndürür. Dönen dizge ayraç karakterini içermez.

Standart \n, \r, \r\n satır sonu ayraçlarından farklı ayraçlara izin vermesi ve dönen dizgenin bu ayracı içermemesi dışında fgets() işlevi gibidir.

Bağımsız Değişkenler

akım

Geçerli bir dosya tanıtıcısı.

uzunluk

Akımdan okunacak baytların sayısı. Negatif değerler desteklenmez. 0 (sıfır), öntanımlı soket tamponu uzunluğu anlamına gelir ve 8192 bayttır.

ayraç

Okumanın duracağı karakter.

Dönen Değerler

En fazla uzunluk baytlık dizge, başarısızlık durumunda false döner.

Ayrıca Bakınız

  • fread() - Dosyayı ikil kipte okur
  • fgets() - Dosya tanıtıcısından bir satır döndürür
  • fgetc() - Dosya tanıtıcısından bir karakter döndürür
add a note

User Contributed Notes 1 note

up
12
pk at ritm dot ru
14 years ago
fgets is faster but stream_get_line is more useful in a tcp server scripts.

when fgets reads some bytes from socket, where EOF is reached, it returns bool(false) same as stream_get_line

BUT if remote client drops connection, and server script will try to read some data with function fgets, function will return bool(false), and stream_get_line will return string(0) ""

so you can detect remote client disconnection with stream_get_line, and cannot with fgets
To Top