fseek(3) Library Functions Manual fseek(3) NOMBRE fgetpos, fseek, fsetpos, ftell, rewind - reposicionarse en un flujo BIBLIOTECA Biblioteca Estandar C (libc, -lc) SINOPSIS #include int fseek(FILE *flujo, long desplto, int origen); long ftell(FILE *flujo); void rewind(FILE *flujo); int fgetpos(FILE *restrict flujo, fpos_t *restrict pos); int fsetpos(FILE *flujo, const fpos_t *pos); DESCRIPCION 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(stream, 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. If the stream refers to a regular file and the resulting stream offset is beyond the size of the file, subsequent writes will extend the file with a hole, up to the offset, before committing any data. See lseek(2) for details on file seeking semantics. VALOR DEVUELTO The rewind() function returns no value. Upon successful completion, fgetpos(), fseek(), fsetpos() return 0, and ftell() returns the current offset. Otherwise, -1 is returned and errno is set to indicate the error. ERRORES EINVAL The whence argument to fseek() was not SEEK_SET, SEEK_END, or SEEK_CUR. Or: the resulting file offset would be negative. ESPIPE The file descriptor underlying stream is not seekable (e.g., it refers to a pipe, FIFO, or socket). 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). ATRIBUTOS Para obtener una explicacion de los terminos usados en esta seccion, vease attributes(7). +-----------------------------+--------------------+-------------------+ |Interfaz | Atributo | Valor | +-----------------------------+--------------------+-------------------+ |fseek(), ftell(), rewind(), | Seguridad del hilo | Multi-hilo seguro | |fgetpos(), fsetpos() | | | +-----------------------------+--------------------+-------------------+ ESTANDARES C11, POSIX.1-2008. HISTORIAL POSIX.1-2001, C89. VEASE TAMBIEN lseek(2), fseeko(3) TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Gerardo Aburruzaga Garcia Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . Paginas de manual de Linux 6.06 31 Octubre 2023 fseek(3)