CKTIS / C
fseek — prúdová funkcia C23
`fseek(stream, offset, whence)` z `<stdio.h>` nastaví pozíciu súboru vzhľadom na `SEEK_SET`, `SEEK_CUR` alebo `SEEK_END`. Pri úspechu vracia `0`, pri chybe nenulovú hodnotu; úspech zmaže príznak konca súboru a účinky `ungetc`.
Verzia: C23
Syntax
int fseek(FILE *stream, long int offset, int whence);fseek(stream, offset, whence) z <stdio.h> nastaví pozíciu súboru vzhľadom na SEEK_SET, SEEK_CUR alebo SEEK_END. Pri úspechu vracia 0, pri chybe nenulovú hodnotu; úspech zmaže príznak konca súboru a účinky ungetc.
Príklad zapíše ABCDE, presunie sa o dva bajty od SEEK_SET a prečíta C. Potom číta do konca, pozoruje feof == 1, vráti sa na začiatok a vytlačí C 1 0, čo ukazuje zmazanie príznaku EOF.
V binárnom prúde sa posun meria v bajtoch, ale SEEK_END nemusí byť podporovaný. Pre textový prúd je prenosný len offset 0 alebo skoršia hodnota z ftell použitá s SEEK_SET. Po chybe môže byť pozícia neurčená; nepolohujte prúd, ktorý túto operáciu nepodporuje.
Príklady
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF||fseek(stream,2L,SEEK_SET)!=0){fclose(stream);return 1;}int selected=fgetc(stream);while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fseek(stream,0L,SEEK_SET)!=0){fclose(stream);return 1;}int after=feof(stream)!=0;printf("%c %d %d\n",selected,before,after);return fclose(stream)==0?0:1;}
Výsledok
C 1 0
Príklad zapíše `ABCDE`, presunie sa o dva bajty od `SEEK_SET` a prečíta `C`. Potom číta do konca, pozoruje `feof == 1`, vráti sa na začiatok a vytlačí `C 1 0`, čo ukazuje zmazanie príznaku EOF.