eio_seek

(PECL eio >= 0.5.0b)

eio_seek — Repositionne le curseur d'un fichier ouvert

Description

resource eio_seek ( mixed $fd , int $offset , int $whence [, int $pri = EIO_PRI_DEFAULT [, callable $callback = NULL [, mixed $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.

Liste de paramètres

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.

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

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

Variable arbitraire à passer à la fonction de rappel callback.

Valeurs de retour

eio_seek() retourne la ressource demandée en cas de succès, ou FALSE si une erreur survient.