php_stream_seek

(no version information, might be only in CVS)

php_stream_seek -- Modifie la position du pointeur de flux

Description

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

php_stream_seek() modifie la position du pointeur de position du flux 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 flux, à la position courante ou à la fin du flux, respectivement.

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

Note : Tous les flux 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 flux suporte le pointeur de position. Si le flux est (par exemple) basé sur des fichiers qui travaille avec des flux de pipes, l'API de flux ne pourra pas appliquer une telle émulation. Le positionnement du pointeur de flux échouera et une erreur sera retournée.