fscanf
fstat
Fonctions sur les systèmes 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` = 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($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").

### Voir aussi

- ftell() - Renvoie la position courant du pointeur de fichier
- rewind() - Replace le pointeur de fichier au début

fscanf
fstat
Fonctions sur les systèmes de fichiers
PHP Manual