fseek

Sposta un puntatore sul file

Descrizione

int fseek(resource $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.

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.

Vedere anche ftell e rewind.