(PHP 4, PHP 5, PHP 7)
fseek — Dosya tanıtıcısında konumu bir yerden başka bir yere taşır
$dt
, int $nereye
[, int $nereden
] ) : int
Dosya tanıtıcısı dt
ile belirtilen bir dosyada konum
göstericisini belli bir konuma götürür. Dosyanın başlangıcından
itibaren bayt sayısı olarak ölçülen yeni konum,
nereden
değerine nereye
değeri eklenerek belirtilir.
dt
Bir dosya tanıtıcısı. Genellikle fopen() kullanılarak oluşturulur.
nereye
Yeni konum.
Konumu dosya sonunun öncesine taşımak için bu değiştirgeyle negatif bir
değer, nereye
değiştirgesiyle de
SEEK_END
aktarın.
nereye
Mevcut konumun nasıl yorumlanacağı belirtilir:
SEEK_SET
- nereye
konumunun dosya başlangıcına göre belirtildiği varsayılır.SEEK_CUR
- nereye
konumunun mevcut dosya konumuna göre bayt sayısı olarak belirtildiği
varsayılır. Bu miktar pozitif veya negatif olabilir. SEEK_END
- nereye
konumunun dosya sonuna göre belirtildiği varsayılır.
Eğer nereden
belirtilmezse,
SEEK_SET
öntanımlıdır.
Başarı durumunda 0 aksi takdirde -1 döner. Dosya sonundan sonrasına konumlama bir hata olarak ele alınmaz.
Örnek 1 - fseek() örneği
<?php
$fp = fopen('dosya.txt', 'r');
// Biraz veri okuyalım
$data = fgets($fp, 4096);
// rewind($fp) çağrısı yapmış gibi
// dosyanın başına dönelim;
fseek($fp, 0);
?>
Bilginize:
Eğer dosya ekleme ("a" veya "a+") kipinde açılmışsa, dosyaya yazılan her veri konuma bakılmaksızın daima dosyanın sonuna eklenir.
Bilginize:
Eğer "http://" veya "ftp://" biçemi kullanılırsa fopen() tarafından döndürülen dosya tanıtıcısı kullanılmayabilir. Ayrıca, fseek() işlevi, sadece sona ekleme kipinde ('a' seçeneğiyle) açılmış akımlar için yanlış sonuçlar verebilir.