Fonctions sur les systèmes de fichiers
PHP Manual

fseek

(PHP 4, PHP 5)

fseekModifie la position du pointeur de fichier

Description

int fseek ( resource $handle , int $offset [, int $whence = SEEK_SET ] )

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 et définir le paramètre whence à la valeur SEEK_END.

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.

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($fp4096);

// retourne au début du fichier
// identique à rewind($fp);
fseek($fp0);

?>

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 utilisent les formats http:// ou ftp://. fseek() donne également des résultats indéfinis pour les flux "append-only" (ouvert avec l'option "a").

Voir aussi


Fonctions sur les systèmes de fichiers
PHP Manual