fseek

(PHP 3, PHP 4 , PHP 5)

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 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().

Hosting by: hurra.com
Generated: 2007-01-26 17:56:41