Système de fichiers
PHP Manual

fseek

(PHP 4, PHP 5)

fseek — Modifie la position du pointeur de fichier

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 :

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.

Example#1 Exemple avec fseek()

<?php

$fp 
fopen('un_fichier.txt''r');

// lit quelques données
$data fgets($fp4096);

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

?>

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().


Système de fichiers
PHP Manual