|
8.38.47 fseek()Modifie la position du pointeur de fichier[ Exemples avec fseek ] PHP 3, PHP 4, PHP 5
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 avec fseek |
<?php
$fp = fopen('un_fichier.txt');
// 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
.
|
