(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SplFileObject::fseek — Se déplace à une position donnée
Description
public
SplFileObject::fseek(int
$offset
, int
$whence
=
SEEK_SET
): int
Liste de paramètres
-
offset
-
La position. Une valeur négative peut être utilisée pour se déplacer en arrière
dans le fichier, ce qui peut être utile lorsque SEEK_END est utilisé
comme valeur du paramètre whence
.
-
whence
-
Les valeurs pour le paramètre whence
sont :
SEEK_SET
- La position sera égale à offset
octets.
SEEK_CUR
- La position sera égale à la position courante, plus offset
.
SEEK_END
- La position sera égale à la fin du fichier, plus offset
.
Si whence
n'est pas spécifié, il prendra la valeur SEEK_SET
.
Valeurs de retour
Retourne 0 si le déplacement s'est effectué avec succès, -1 sinon.
Notez que la tentative de déplacement après la fin du fichier n'est pas
considérée comme une erreur.
Exemples
Exemple #1 Exemple avec splfileobject::fseek()
<?php
$file = new SplFileObject("somefile.txt");
// Lecture de la première ligne
$data = $file->fgets();
// Se déplace au début du fichier
// Identique à $file->rewind();
$file->fseek(0);
?>
Voir aussi
- fseek() - Modifie la position du pointeur de fichier