Manuale PHP
Indietro |  | Avanti

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

Indietro | Partenza | Avanti
fscanf | Risali | fstat