fseek
(PHP 4, PHP 5)
fseek — Modifie la position du pointeur de fichier
Description
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 .
Liste de param�tres
- handle
-
Un pointeur de syst�me de fichiers de type resource qui est habituellement cr�� en utilisant la fonction fopen().
- offset
-
La position.
Pour se d�placer � une position avant la fin du fichier, vous devez passer une valeur n�gative � offset .
- whence
-
Les valeurs possibles pour whence sont :
- SEEK_SET : la position finale vaut offset octets.
- SEEK_CUR : la position finale sera 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 octets.
Si whence n'est pas sp�cifi�e, il vaut par d�faut SEEK_SET.
Valeurs de retour
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.
Exemples
Exemple #1 Exemple avec fseek()
<?php
$fp = fopen('somefile.txt', 'r');
// lit quelques donn�es
$data = fgets($fp, 4096);
// retourne au d�but du fichier
// identique � rewind($fp);
fseek($fp, 0);
?>
Notes
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.
Note: 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 l'option "a").