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.