Ubuntu manuals

Provided by: manpages-es_1.55-10_all

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'ON

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

       La  funcion ftell obtiene el valor actual del indicador de posicion del
       fichero para el flujo apuntado por flujo.

       La funcion rewind mueve el indicador de posicion 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 tambien 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 unica
       manera de reposicionar un flujo de texto de forma transportable.

VALOR DEVUELTO

       La funcion 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 tambien 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
       estandar ANSI X3.159-1989 (``C ANSI'').

V'EASE TAMBI'EN

       lseek(2), fseeko(3)