fseek

(PHP 4, PHP 5, PHP 7, PHP 8)

fseek — Sposta un puntatore sul file

Descrizione

fseek(resource $handle, int $offset, int $whence = ?): int

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.

Vedere anche ftell() e rewind().