(PECL eio >= 0.5.0b)
eio_seek — Repositionne le curseur d'un fichier ouvert
$fd
,$offset
,$whence
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULL
eio_seek() repositionne le curseur du fichier ouvert
spécifié par l'argument fd
(qui peut être un flux,
une ressource de socket ou un descripteur de fichier) à la position
offset
suivant la directive
whence
comme suit :
EIO_SEEK_SET
- Définit la position à offset
octets.EIO_SEEK_CUR
- Définit la position à la position courante, plus offset
.EIO_SEEK_END
- Définit la position à la fin du fichier, plus offset
.fd
Un flux, une ressource de socket, ou un descripteur de fichier numérique
offset
Point de départ depuis lequel les données vont commencer à être lues.
length
Nombre d'octets à lire.
pri
La priorité de la requête : EIO_PRI_DEFAULT
, EIO_PRI_MIN
, EIO_PRI_MAX
, ou null
.
Si null
est passé, le paramètre pri
, en interne, est défini à
EIO_PRI_DEFAULT
.
callback
La fonction de rappel callback
est appelée lorsque la requête est terminée.
Elle doit correspondre au prototype suivant :
void callback(mixed $data, int $result[, resource $req]);
data
représente les données personnalisées passées à la requête.
result
représente la valeur résultante spécifique à la requête ; basiquement, la valeur retournée par l'appel système correspondant.
req
est la ressource optionnelle de la requête qui peut être utilisée avec les fonctions comme eio_get_last_error()
data
Variable arbitraire à passer à la fonction de rappel
callback
.
eio_seek() retourne la ressource demandée
en cas de succès, ou false
si une erreur survient.