NOMBRE

       fgetpos, fseek, fsetpos, ftell, rewind - reposicionarse en un flujo

SINOPSIS

       #include <stdio.h>

       int fseek( FILE *flujo, long desplto, int origen);
       long ftell( FILE *flujo);
       void rewind( FILE *flujo);
       int fgetpos( FILE *flujo, fpos_t *pos);
       int fsetpos( FILE *flujo, fpos_t *pos);

DESCRIPCIÓN

       La  función  fseek  mueve el indicador de posición del fichero correspondiente al flujo de
       datos apuntado por flujo.  La nueva  posición,  medida  en  bytes,  se  obtiene  añadiendo
       desplto  bytes  a la posición especificada por origen.  Si origen es SEEK_SET, SEEK_CUR, o
       SEEK_END, el desplazamiento es relativo al comienzo del fichero, a la posición  actual,  o
       al  final  del  fichero, respectivamente. Una llamada exitosa a la función fseek limpia el
       indicador de fin-de-fichero para el  flujo  y  deshace  cualquier  efecto  de  la  función
       ungetc(3) en el mismo flujo.

       La  función  ftell  obtiene  el valor actual del indicador de posición del fichero para el
       flujo apuntado por flujo.

       La función rewind mueve el indicador de posición del fichero para el  flujo  apuntado  por
       flujo al principio del fichero. Es equivalente a:

              (void)fseek(flujo, 0L, SEEK_SET)

       salvo en que el indicador de error para el flujo también se limpia (vea clearerr(3)).

       Las  funciones  fgetpos y fsetpos son interfaces alternativas equivalentes a ftell y fseek
       (con  el  origen  puesto  a  SEEK_SET),  poniendo  y  almacenando  el  valor  actual   del
       desplazamiento  desde o en el objeto referenciado por pos.  En algunos sistemas no UNIX un
       objeto fpos_t puede ser un objeto complejo y estas rutinas pueden ser la única  manera  de
       reposicionar un flujo de texto de forma transportable.

VALOR DEVUELTO

       La  función  rewind  no  devuelve  nada.  Cuando  acaban  bien,  fgetpos, fseek, y fsetpos
       devuelven 0, y ftell devuelve el desplazamiento actual. Cuando acaban mal, devuelve  -1  y
       se pone un valor apropiado en la variable global errno.

ERRORES

       EBADF  El flujo especificado es tal que no permite el acceso directo.

       EINVAL El argumento origen de fseek no era SEEK_SET, SEEK_END, ni SEEK_CUR.

       Las  funciones  fgetpos, fseek, fsetpos, y ftell pueden fallar también y poner un valor en
       errno para cualquiera de los errores especificados para las rutinas  fflush(3),  fstat(2),
       lseek(2), y malloc(3).

CONFORME A

       Las funciones fgetpos, fsetpos, fseek, ftell, y rewind siguen el estándar ANSI X3.159-1989
       (``C ANSI'').

VÉASE TAMBIÉN

       lseek(2), fseeko(3)