Sistema de archivos
PHP Manual

fseek

(PHP 4, PHP 5)

fseek — Realiza una búsqueda sobre un apuntador de archivo

Descripción

int fseek ( resource $gestor , int $desplazamiento [, int $desde ] )

Establece el indicador de posición para el archivo referenciado por gestor . La nueva posición, medida en bytes desde el comienzo del archivo, so obtiene al sumar desplazamiento con la posición especificada por desde .

Lista de parámetros

gestor

A file system pointer resource that is typically created using fopen().

desplazamiento

El desplazamiento.

Para moverse a una posición antes del final de archivo, debe pasarse un valor negativo en desplazamiento .

desde

Los valores de desde son:

  • SEEK_SET - Define la posición igual a desplazamiento bytes.
  • SEEK_CUR - Define la posición como la posición actual mas desplazamiento .
  • SEEK_END - Define la posición como el final-de-archivo mas desplazamiento .

Si no se especifica desde , se asume que sea SEEK_SET.

Valores retornados

De tener éxito, la función devuelve 0; de lo contrario devuelve -1. Note que realizar una reubicación más allá del final de archivo no se considera un error.

Ejemplos

Example#1 Ejemplo de fseek()

<?php

$da 
fopen('algun_archivo.txt''r');

// leer datos
$datos fgets($da4096);

// moverse de vuelta al comienzo del archivo
// igual que rewind($da);
fseek($da0);

?>

Notes

Note: Si el archivo es abierto en modo de adición ("a" o "a+"), cualquier información escrita en el archivo será siempre agregada al final, independientemente de la posición en el archivo.

Note: Puede que no sea posible usar la función sobre apuntadores de archivo devueltos por fopen() si usan los formatos "http://" o "ftp://". fseek() produce también resultados indefinidos para secuencias de adición (abiertas con la bandera "a").

Ver también


Sistema de archivos
PHP Manual