streamWrapper::stream_seek
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_seek — Place le pointeur de flux à une position
Description
$offset
, int $whence
= SEEK_SET
)Cette méthode est appelée en réponse à fseek().
La position de lecture/écriture doit être modifiée pour refléter
la nouvelle position offset
et
whence
.
Liste de paramètres
-
offset
-
La position à rechercher dans le flux.
-
whence
-
Les valeurs possibles sont :
SEEK_SET
: la nouvelle position vautoffset
octets.SEEK_CUR
: la nouvelle position vaut la position courante plusoffset
.SEEK_END
: la nouvelle position vaut la fin de fichier plusoffset
.
Valeurs de retour
Retourne TRUE
si la position a été mise à jour,
FALSE
sinon.
Notes
Note:
Si elle n'est pas implémentée,
FALSE
sera utilisée comme valeur de retour.
Note:
En cas de succès, streamWrapper::stream_tell() est appelée directement après streamWrapper::stream_seek(). Si streamWrapper::stream_tell() échoue, la valeur retournée à la fonction appelante
FALSE
.
Note:
Toutes les opérations de déplacement sur un flux ne nécessitent pas obligatoirement l'utilisation de cette fonction. Les flux PHP ont la lecture en mémoire tampon d'activé par défaut (voir aussi la fonction stream_set_read_buffer()) ainsi que la déplacement dans ce flux, pouvant être effectué en déplaçant le pointeur du buffer.