(PHP 4, PHP 5)
fgets — Dosya tanıtıcısından bir satır döndürür
Belirtilen dosya tanıtıcısından bir satır döndürür.
Dosya tanıtıcısı geçerli olmalı ve fopen() veya fsockopen() tarafından başarıyla açılmış bir dosya için döndürülmüş olmalıdır (ve henüz fclose() tarafından kapatılmamış olmalıdır).
uzunluk - 1 bayt okununca bir satırsonu karakterinde veya dosya sonunda (hangisi önce vuku bulursa) okuma işlemi durur. Bir uzunluk belirtilmezse akımdan okuma işlemi satırın sonuna erişilinceye kadar sürdürülür.
Bilginize:
PHP 4.3.0'a kadar, uzunluk belirtilmediğinde satır uzunluğu 1024 bayt kabul edilirdi. Bir dosyadaki satırların büyük çoğunluğu 8KB'tan büyükse, azami bir uzunluk belirtmek betiğiniz için daha verimli olabilir.
Dosya tanıtıcısı dt ile belirtilen bir dosyadan uzunluk - 1 baytlık veriyi bir dizge içinde döndürür.
Bir hata oluşursa FALSE döner.
Sürüm: | Açıklama |
---|---|
4.3.0 | fgets() dosyaları ikil kipte okumaya başladı. |
4.2.0 | uzunluk değiştirgesi isteğe bağlı oldu. |
Örnek 1 - Bir dosyanın satır satır okunması
<?php
$dt = @fopen("/tmp/inputfile.txt", "r");
if ($dt) {
while (!feof($dt)) {
$tampon = fgets($dt, 4096);
echo $tampon;
}
fclose($dt);
}
?>
Bilginize: Eğer PHP'nin Macintosh bilgisayarlarda çalışırken veya bu bilgisayarlarda oluşturulmuş dosyalarla çalışırken satır sonlarını tanımamaması gibi bir sorunla karşılaşırsanız, auto_detect_line_endings çalışma anı seçeneğini etkin kılarak bu sorunu çözebilirsiniz.
Bilginize:
fgets() işlevinin 'C' dilindeki anlamlandırılmasını bilenler dosya sonu karakterinin (EOF) döndürülüşü ile ilgili farka dikkat etmelidir.