CKTIS / C
fsetpos — funkcija toka C23
`fsetpos(stream, pos)` iz `<stdio.h>` obnovi kazalnik položaja in morebitni objekt `mbstate_t` iz vrednosti, ki jo je shranil uspešen `fgetpos` na toku, povezanem z isto datoteko. Ob uspehu vrne `0`, ob napaki neničelno vrednost.
Različica: C23
Sintaksa
int fsetpos(FILE *stream, const fpos_t *pos);fsetpos(stream, pos) iz <stdio.h> obnovi kazalnik položaja in morebitni objekt mbstate_t iz vrednosti, ki jo je shranil uspešen fgetpos na toku, povezanem z isto datoteko. Ob uspehu vrne 0, ob napaki neničelno vrednost.
Primer zapiše ABCDE, shrani položaj za AB, bere do konca in opazi feof == 1. Nato fsetpos obnovi stanje; 1 0 C pokaže izbris EOF in ponovno branje C z želenega položaja.
Uspeh razveljavi učinke ungetc, počisti kazalnik konca in dovoli, da je naslednja operacija posodobitvenega toka vhod ali izhod. fpos_t je nepregleden: na njem ne računajte in ga ne prenašajte med datotekami. Ob napaki branja ali pisanja se nastavi kazalnik napake; vrnitev je neničelna, errno pa dobi pozitivno od izvedbe odvisno vrednost.
Primeri
#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;}
Rezultat
1 0 C
Primer zapiše `ABCDE`, shrani položaj za `AB`, bere do konca in opazi `feof == 1`. Nato `fsetpos` obnovi stanje; `1 0 C` pokaže izbris EOF in ponovno branje `C` z želenega položaja.