Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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`.

Źródła