Manuel PHP
Précédent |  | Suivant

# fseek

(PHP 3, 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 :

`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 1. 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.

Voir aussi ftell() et rewind().

Précédent | Sommaire | Suivant
fscanf | Niveau supérieur | fstat