CKTIS / C
fsetpos — prúdová funkcia C23
`fsetpos(stream, pos)` z `<stdio.h>` obnoví ukazovateľ pozície a prípadný objekt `mbstate_t` z hodnoty uloženej úspešným `fgetpos` na prúde spojenom s rovnakým súborom. Pri úspechu vracia `0`, pri chybe nenulovú hodnotu.
Verzia: C23
Syntax
int fsetpos(FILE *stream, const fpos_t *pos);fsetpos(stream, pos) z <stdio.h> obnoví ukazovateľ pozície a prípadný objekt mbstate_t z hodnoty uloženej úspešným fgetpos na prúde spojenom s rovnakým súborom. Pri úspechu vracia 0, pri chybe nenulovú hodnotu.
Príklad zapíše ABCDE, uloží pozíciu za AB, číta do konca a zistí feof == 1. Potom fsetpos obnoví stav; 1 0 C ukazuje zmazanie EOF a nové prečítanie C zo zamýšľanej pozície.
Úspech zruší účinky ungetc, zmaže príznak konca a dovolí ako ďalšiu operáciu aktualizačného prúdu čítanie alebo zápis. fpos_t je nepriehľadný: nerobte s ním aritmetiku ani ho neprenášajte medzi súbormi. Pri chybe čítania či zápisu sa nastaví príznak chyby; návrat je nenulový a errno dostane kladnú hodnotu závislú od implementácie.
Príklady
#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;}
Výsledok
1 0 C
Príklad zapíše `ABCDE`, uloží pozíciu za `AB`, číta do konca a zistí `feof == 1`. Potom `fsetpos` obnoví stav; `1 0 C` ukazuje zmazanie EOF a nové prečítanie `C` zo zamýšľanej pozície.