php_stream_seek

(no version information, might be only in CVS)

php_stream_seek -- Modifie la position du pointeur de flôt

Description

int php_stream_seek ( php_stream * stream, off_t offset, int whence)

php_stream_seek() modifie la position du pointeur de position du flôt stream. La nouvelle position est déterminée en ajoutant offset à la position indiquée par whence. Si whence vaut SEEK_SET, SEEK_CUR ou SEEK_END l'offset sera relativ au début du flôt, à la position courante ou à la fin du flôt, respectivement.

php_stream_seek() retourne 0 en cas de succès, et -1 en cas d'erreur.

Note : Tous les flôts ne supportent pas la modification de la position du pointeur, même si l'API va émuler un tel pointeur si whence vaut SEEK_CUR et offset est positif, en appelant php_stream_read() pour lire (et ignorer) offset octets.

L'émulation est uniquement appliquée si l'implémentation du gestionnaire de flôt suporte le pointeur de position. Si le flôt est (par exemple) basé sur des fichiers qui travaille avec des flôt de pipes, l'API de flôt ne pourra pas appliquer une telle émulation. Le positionnement du pointeur de flôt échouera et une erreur sera retournée.