fseek

(PHP 3, 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, cuyos valores se definen como se indica a continuación:

SEEK_SET - Define la posición igual a desplazamiento bytes.
SEEK_CUR - Define la posición como la posición actual más desplazamiento.
SEEK_END - Define la posición como el final-de-archivo más desplazamiento. (Para moverse a una posición anterior al final-de-archivo, es necesario pasar un valor negativo en desplazamiento.)

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

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.

Ejemplo 1. Ejemplo de fseek()

<?php

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

// leer datos
$datos = fgets($da, 4096);

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

?>

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").

Nota: El argumento desde fue agregado después de PHP 4.0.0.

Nota: 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.

Vea también ftell() y rewind().

Hosting by: hurra.com
Generated: 2007-01-26 18:00:58