fseek
(PHP 4, PHP 5)
fseek — Sposta un puntatore sul file
Descrizione
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 "https://" 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.