fseek
(PHP 4, PHP 5)
fseek — Realiza una búsqueda sobre un apuntador de archivo
Descripción
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($da, 4096);
// moverse de vuelta al comienzo del archivo
// igual que rewind($da);
fseek($da, 0);
?>
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 "https://" o "ftp://". fseek() produce también resultados indefinidos para secuencias de adición (abiertas con la bandera "a").