(PHP 4, PHP 5)
fseek — Modifie la position du pointeur de fichier
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 794. 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.