dio_seek
(PHP 4 >= 4.2.0, PHP 5 <= 5.0.5)
dio_seek — Si posiziona al byte pos del file indicato da fd
Descrizione
La funzione dio_seek() viene utilizzata per modificare la posizione nel file indicato dal descrittore fd .
Elenco dei parametri
- fd
-
Descrittore di file restituito da dio_open().
- pos
-
La nuova posizione.
- whence
-
specifica come debba essere interpretata la posizione indicata da pos :
-
SEEK_SET (default) - Indica che pos è determinato dall'inizio del file.
-
SEEK_CUR - Indica che pos è il numero di caratteri dalla posizione attuale. Questo valore può essere positivo o negativo.
-
SEEK_END - Indica che pos è il numero di caratteri dalla fine del file. Un valore negativo specifica una posizione all'interno dell'estensione del file; un valore positivo specifica una posizione oltre la fine corrente del file. Se si specifica una posizione oltre la fine del file, e vi si scrive dei dati, il file sarà allungato e riempito di zero fino a quella posizione.
-
Valori restituiti
Esempi
Example#1 Posizionamento in un file
<?php
$fd = dio_open('/dev/ttyS0', O_RDWR);
dio_seek($fd, 10, SEEK_SET);
// Si posiziona a 10 caratteri dall'inizio del file
dio_seek($fd, -2, SEEK_CUR);
// Si posiziona a 8 caratteri dall'inizio del file
dio_seek($fd, -5, SEEK_END);
// Si posiziona a 5 caratteri dalla fine del file
dio_seek($fd, 10, SEEK_END);
// Si posiziona a 10 caratteri dopo la fine del file
// i 10 caratteri tra la fine del file e la posizione corrente
// sono riempiti con zero.
dio_close($fd);
?>