(PHP 4, PHP 5)
fseek — Sposta un puntatore sul file
$handle
, int $offset
[, int $whence
] )
Imposta l'indicatore di posizione del file riferito da
handle. La nuova posizione, misurata in byte
dall'inizio del file, si ottiene aggiungendo
offset alla posizione specificata da
whence, i cui valori sono definiti come
segue:
SEEK_SET - Imposta la posizione uguale a offset byte.SEEK_CUR - Imposta la posizione alla attuale più offset.SEEK_END - Imposta la posizione alla fine del file più offset.
(To move to a position before the end-of-file, you need to pass a negative
value in offset.)
Se whence non viene specificato, viene assunto come
SEEK_SET.
In caso di successo, restituisce 0; altrimenti, restituisce -1. Nota che spostarsi oltre EOF non è considerato un errore.
Example #1 Esempio di uso di fseek()
<?php
$fp = fopen('somefile.txt');
// Lettura di qualche dato
$data = fgets($fp, 4096);
// si torna ad inizio file
// come rewind($fp);
fseek($fp, 0);
?>
Non può essere usato su puntatori a file restituiti da fopen() se è in uso il formato "http://" o "ftp://". fseek() da anche risultati non definiti per stream in modalità append-only (aperti con il flag "a").
Nota:
L'argomento
whenceè stato aggiunto dopo PHP 4.0.0.