SplFileObject::fseek

(PHP 5 >= 5.1.0, PHP 7)

SplFileObject::fseekMueve el apuntador interno a una posición

Descripción

public SplFileObject::fseek ( int $offset [, int $whence = SEEK_SET ] ) : int

Mover el apuntador interno a una posición en el fichero medido en bytes desde el princpio de el fichero, obtenido añadiendo offset a la posición especificada por whence.

Parámetros

offset

El índice. Un valor negativo puede ser utilizado para mover hacía atrás por el fichero que será útil cuando SEEK_END es usado como un valor de whence.

whence

Los valores de whence son:

  • SEEK_SET - Establece la posición igual a offset bytes.
  • SEEK_CUR - Establece la posición a la ubicación actual más offset.
  • SEEK_END - Establece la posición al final de el fichero más offset.

Si no se especifica whence, se supone que es SEEK_SET.

Valores devueltos

Devuelve 0 si la búsqueda fué exitosa, -1 en caso contrario. Tenga en cuenta que buscando un EOF pasado no se considera como un error.

Ejemplos

Ejemplo #1 Ejemplo de SplFileObject::fseek()

<?php
$file 
= new SplFileInfo("algunfichero.txt");

// Leer la primera línea
$data $file->fgets();

// Mover atrás a el principio de el fichero
// Igual que $file->rewind();
$file->fseek(0);
?>

Ver también

  • fseek() - Busca sobre un puntero a un fichero