fscanf
fstat
Filesystem Functions
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($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 "http://" o "ftp://". fseek() produce también resultados indefinidos para secuencias de adición (abiertas con la bandera "a").

### Ver también

- ftell() - Indica la posición de lectura/escritura del apuntador de archivo
- rewind() - Retroceder la posición de un apuntador de archivo

fscanf
fstat
Filesystem Functions
PHP Manual