CKTIS / C
fsetpos — proudová funkce C23
`fsetpos(stream, pos)` z `<stdio.h>` obnoví ukazatel pozice a případný objekt `mbstate_t` z hodnoty uložené úspěšným `fgetpos` na proudu spojeném se stejným souborem. Při úspěchu vrací `0`, při chybě nenulovou hodnotu.
Verze: C23
Syntaxe
int fsetpos(FILE *stream, const fpos_t *pos);fsetpos(stream, pos) z <stdio.h> obnoví ukazatel pozice a případný objekt mbstate_t z hodnoty uložené úspěšným fgetpos na proudu spojeném se stejným souborem. Při úspěchu vrací 0, při chybě nenulovou hodnotu.
Příklad zapíše ABCDE, uloží pozici za AB, čte do konce a zjistí feof == 1. Poté fsetpos obnoví stav; 1 0 C ukazuje smazání EOF a nové přečtení C ze zamýšlené pozice.
Úspěch zruší účinky ungetc, smaže příznak konce a dovolí jako další operaci aktualizačního proudu čtení nebo zápis. fpos_t je neprůhledný: neprovádějte s ním aritmetiku ani jej nepřenášejte mezi soubory. Při chybě čtení či zápisu se nastaví příznak chyby; návrat je nenulový a errno dostane kladnou hodnotu závislou na implementaci.
Pří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ýsledek
1 0 C
Příklad zapíše `ABCDE`, uloží pozici za `AB`, čte do konce a zjistí `feof == 1`. Poté `fsetpos` obnoví stav; `1 0 C` ukazuje smazání EOF a nové přečtení `C` ze zamýšlené pozice.