CKTIS / C
SEEK_SET, SEEK_CUR, SEEK_END — punkty odniesienia pozycjonowania
Makra SEEK_SET, SEEK_CUR i SEEK_END wybierają punkt odniesienia dla fseek: początek, bieżącą pozycję lub koniec pliku.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdio.h>
int fseek(FILE *stream, long int offset, int whence);
/* whence: SEEK_SET, SEEK_CUR, SEEK_END */Makra z <stdio.h> mają różne wartości całkowite; nie zakładaj konkretnych liczb. Argument whence wybiera podstawę: SEEK_SET — początek pliku, SEEK_CUR — bieżąca pozycja, SEEK_END — koniec pliku.
Dla strumienia binarnego fseek dodaje offset do tej podstawy, licząc w bajtach C. Obsługa SEEK_END nie jest gwarantowana nawet dla strumieni binarnych. Dla strumienia tekstowego offset musi wynosić zero albo pochodzić z wcześniejszego udanego ftell dla tego samego pliku; w drugim przypadku wymagane jest SEEK_SET.
Sprawdzaj wynik fseek: zero oznacza sukces, wartość niezerowa — niepowodzenie.
Przykłady
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *f = tmpfile();
int a, b;
if (f == NULL) return EXIT_FAILURE;
if (fputs("ABCDE", f) == EOF ||
fseek(f, 1L, SEEK_SET) != 0) {
fclose(f);
return EXIT_FAILURE;
}
a = fgetc(f);
if (a == EOF || fseek(f, 1L, SEEK_CUR) != 0) {
fclose(f);
return EXIT_FAILURE;
}
b = fgetc(f);
if (b == EOF || fclose(f) != 0) return EXIT_FAILURE;
if (printf("%c %c\n", a, b) < 0) return EXIT_FAILURE;
return EXIT_SUCCESS;
}Wynik
B D
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.