fsetpos

Establece el indicador de posición de secuencia.

Sintaxis

int fsetpos(
   FILE *stream,
   const fpos_t *pos
);

Parámetros

stream
Puntero a la estructura FILE .

pos
Almacenamiento del indicador de posición.

Valor devuelto

Si la operación se realiza correctamente, fsetpos devuelve 0. En caso de error, la función devuelve un valor distinto de cero y establece errno en una de las siguientes constantes de manifiesto (definidas en ERRNO. H): EBADF, lo que significa que el archivo no es accesible o el objeto al que stream apunta no es una estructura de archivos válida; o EINVAL, lo que significa un valor no válido para stream o pos se ha pasado. Si se pasa un parámetro no válido, estas funciones invocan al controlador de parámetros no válidos, como se describe en Validación de parámetros.

Para obtener más información sobre los códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

La fsetpos función establece el indicador de posición de archivo para stream en el valor de pos, que se obtiene en una llamada anterior a fgetpos en en .stream La función borra el indicador de fin de archivo y deshace los efectos de ungetc en stream. Después de una llamada a fsetpos, la siguiente operación en stream puede ser de entrada o salida.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Función	Encabezado necesario
fsetpos	<stdio.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

Vea el ejemplo de fgetpos.

Consulte también

E/S de secuencia
fgetpos