Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fseek — funkcja strumieniowa C23

`fseek(stream, offset, whence)` z `<stdio.h>` ustawia pozycję pliku strumienia względem `SEEK_SET`, `SEEK_CUR` albo `SEEK_END`. Zwraca `0` przy powodzeniu i wartość niezerową przy błędzie; udane wywołanie kasuje wskaźnik końca pliku oraz skutki `ungetc`.

Wersja: C23

Składnia

int fseek(FILE *stream, long int offset, int whence);

fseek(stream, offset, whence) z <stdio.h> ustawia pozycję pliku strumienia względem SEEK_SET, SEEK_CUR albo SEEK_END. Zwraca 0 przy powodzeniu i wartość niezerową przy błędzie; udane wywołanie kasuje wskaźnik końca pliku oraz skutki ungetc.

Przykład zapisuje ABCDE, przesuwa się o dwa bajty od SEEK_SET i odczytuje C. Następnie dochodzi do końca, obserwuje feof == 1, wraca na początek przez fseek i wypisuje C 1 0, pokazując skasowanie wskaźnika EOF.

W strumieniu binarnym przesunięcie jest liczone w bajtach, lecz obsługa SEEK_END nie musi istnieć. Dla strumienia tekstowego przenośne są tylko offset 0 lub wartość z wcześniejszego ftell użyta z SEEK_SET. Po błędzie pozycja może być nieokreślona; nie używaj fseek na strumieniu, którego pozycjonowanie nie jest obsługiwane.

Przykłady

#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;}

Wynik

C 1 0

Przykład zapisuje `ABCDE`, przesuwa się o dwa bajty od `SEEK_SET` i odczytuje `C`. Następnie dochodzi do końca, obserwuje `feof == 1`, wraca na początek przez `fseek` i wypisuje `C 1 0`, pokazując skasowanie wskaźnika EOF.

Źródła