CKTIS / C
fsetpos — función de flujo de C23
`fsetpos(stream, pos)` de `<stdio.h>` restaura el indicador de posición y, si existe, el objeto `mbstate_t` desde un valor guardado por un `fgetpos` correcto en un flujo asociado al mismo archivo. Devuelve `0` al tener éxito y un valor no nulo al fallar.
Versión: C23
Sintaxis
int fsetpos(FILE *stream, const fpos_t *pos);fsetpos(stream, pos) de <stdio.h> restaura el indicador de posición y, si existe, el objeto mbstate_t desde un valor guardado por un fgetpos correcto en un flujo asociado al mismo archivo. Devuelve 0 al tener éxito y un valor no nulo al fallar.
El ejemplo escribe ABCDE, guarda la posición tras AB, lee hasta el final y observa feof == 1. Después fsetpos restaura el estado; 1 0 C muestra que se borra EOF y se vuelve a leer C desde la posición prevista.
Un éxito deshace los efectos de ungetc, borra el indicador de fin y permite que la siguiente operación de un flujo de actualización sea lectura o escritura. fpos_t es opaco: no hagas aritmética ni transfieras valores entre archivos. Si falla lectura o escritura se activa el indicador de error; devuelve no cero y guarda en errno un valor positivo dependiente de la implementación.
Ejemplos
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF){fclose(stream);return 1;}rewind(stream);if(fgetc(stream)!='A'||fgetc(stream)!='B'){fclose(stream);return 1;}fpos_t pos;if(fgetpos(stream,&pos)!=0){fclose(stream);return 1;}while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fsetpos(stream,&pos)!=0){fclose(stream);return 1;}int after=feof(stream)!=0,character=fgetc(stream);printf("%d %d %c\n",before,after,character);return fclose(stream)==0?0:1;}
Resultado
1 0 C
El ejemplo escribe `ABCDE`, guarda la posición tras `AB`, lee hasta el final y observa `feof == 1`. Después `fsetpos` restaura el estado; `1 0 C` muestra que se borra EOF y se vuelve a leer `C` desde la posición prevista.