Description
int
fseek ( resource handle, int offset [, int whence] )
fseek() modifie le curseur de position
dans le fichier handle. La nouvelle position
mesurée en octets à partir du début du fichier,
est obtenue en additionnant la distance offset
à la position whence. Ce paramètre
peut prendre les valeurs suivantes :
|
SEEK_SET - La position finale vaut
offset octets.
|
|
SEEK_CUR - La position finale vaut la position courante
ajoutée à offset octets.
|
|
SEEK_END - La position finale vaut la position courante
par rapport à la fin du fichier, ajoutée de
offset.
|
Si whence n'est pas spécifiée, il
vaut par défaut SEEK_SET.
fseek() retourne 0 en cas de
succès, et sinon -1. Notez que positionner le pointeur au-delÃ
de la fin du fichier n'est pas une erreur.
Exemple 1. Exemple avec fseek()
<?php
$fp = fopen('un_fichier.txt', 'r');
// lit quelques données
$data = fgets($fp, 4096);
// retourne au début du fichier
// identique à rewind($fp);
fseek($fp, 0);
?>
|
|
fseek() ne peut pas être utilisé sur les pointeurs
retournés par fopen() s'ils sont au format HTTP ou FTP.
fseek() donne également des résultats indéfinis
pour les flux "append-only" (ouvert avec le flag "a").
Note :
Le paramètre whence a été ajouté en PHP 4.0.0.
Note :
Si vous ouvrez le fichier avec le mode "a" ou "a+", toutes les données que vous
écrirez dans le fichier seront toujours ajoutées, sans se soucier de la position dans le fichier.
Voir aussi
ftell() et
rewind().
