CKTIS / C
fseek — proudová funkce C23
`fseek(stream, offset, whence)` z `<stdio.h>` nastaví pozici souboru vzhledem k `SEEK_SET`, `SEEK_CUR` nebo `SEEK_END`. Při úspěchu vrací `0`, při chybě nenulovou hodnotu; úspěch smaže příznak konce souboru a účinky `ungetc`.
Verze: C23
Syntaxe
int fseek(FILE *stream, long int offset, int whence);fseek(stream, offset, whence) z <stdio.h> nastaví pozici souboru vzhledem k SEEK_SET, SEEK_CUR nebo SEEK_END. Při úspěchu vrací 0, při chybě nenulovou hodnotu; úspěch smaže příznak konce souboru a účinky ungetc.
Příklad zapíše ABCDE, přesune se o dva bajty od SEEK_SET a přečte C. Pak čte do konce, pozoruje feof == 1, vrátí se na začátek a vytiskne C 1 0, což ukazuje smazání příznaku EOF.
V binárním proudu se posun měří v bajtech, ale SEEK_END nemusí být podporován. Pro textový proud je přenositelný jen offset 0 nebo dřívější hodnota z ftell použitá s SEEK_SET. Po chybě může být pozice neurčená; nepozicujte proud, který tuto operaci nepodporuje.
Pří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ýsledek
C 1 0
Příklad zapíše `ABCDE`, přesune se o dva bajty od `SEEK_SET` a přečte `C`. Pak čte do konce, pozoruje `feof == 1`, vrátí se na začátek a vytiskne `C 1 0`, což ukazuje smazání příznaku EOF.