CKTIS / C
ftell — funkcja strumieniowa C23
`ftell(stream)` z `<stdio.h>` pobiera bieżący wskaźnik pozycji pliku. Dla strumienia binarnego wynik jest liczbą znaków od początku pliku; dla tekstowego jest nieprzezroczystą informacją, którą można przekazać z `SEEK_SET` do `fseek`, by wrócić do tej samej pozycji.
Wersja: C23
Składnia
long int ftell(FILE *stream);ftell(stream) z <stdio.h> pobiera bieżący wskaźnik pozycji pliku. Dla strumienia binarnego wynik jest liczbą znaków od początku pliku; dla tekstowego jest nieprzezroczystą informacją, którą można przekazać z SEEK_SET do fseek, by wrócić do tej samej pozycji.
Przykład zapisuje pięć bajtów ABCDE do binarnego pliku tymczasowego, więc pierwsze ftell daje 5. Po fseek(..., 2L, SEEK_SET) drugie daje 2, a kolejny odczyt zwraca C; program wypisuje 5 2 C.
Różnica dwóch wartości dla strumienia tekstowego nie musi mierzyć liczby odczytanych ani zapisanych znaków. Przy błędzie funkcja zwraca -1L i zapisuje dodatnie, zależne od implementacji errno; zawsze sprawdzaj ten sentinel przed użyciem wyniku. Wartość może nie mieścić się w long dla dużego pliku, a pozycję wraz ze stanem wielobajtowym lepiej zachowywać przez fgetpos i fsetpos.
Przykłady
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fwrite("ABCDE",1,5,stream)!=5){fclose(stream);return 1;}long end=ftell(stream);if(end<0||fseek(stream,2L,SEEK_SET)!=0){fclose(stream);return 1;}long middle=ftell(stream);int character=fgetc(stream);printf("%ld %ld %c\n",end,middle,character);return fclose(stream)==0?0:1;}
Wynik
5 2 C
Przykład zapisuje pięć bajtów `ABCDE` do binarnego pliku tymczasowego, więc pierwsze `ftell` daje `5`. Po `fseek(..., 2L, SEEK_SET)` drugie daje `2`, a kolejny odczyt zwraca `C`; program wypisuje `5 2 C`.