CKTIS / C
ftell — prúdová funkcia C23
`ftell(stream)` z `<stdio.h>` získa aktuálny ukazovateľ pozície. Pre binárny prúd výsledok počíta znaky od začiatku súboru; pre textový prúd ide o nepriehľadnú informáciu odovzdateľnú `fseek` s `SEEK_SET` na návrat na rovnakú pozíciu.
Verzia: C23
Syntax
long int ftell(FILE *stream);ftell(stream) z <stdio.h> získa aktuálny ukazovateľ pozície. Pre binárny prúd výsledok počíta znaky od začiatku súboru; pre textový prúd ide o nepriehľadnú informáciu odovzdateľnú fseek s SEEK_SET na návrat na rovnakú pozíciu.
Príklad zapíše päť bajtov ABCDE do binárneho dočasného súboru, takže prvý ftell dá 5. Po fseek(..., 2L, SEEK_SET) druhý dá 2 a nasledujúce čítanie získa C; program vytlačí 5 2 C.
Rozdiel dvoch hodnôt textového prúdu nemusí merať počet prečítaných či zapísaných znakov. Pri chybe funkcia vráti -1L a uloží do errno kladnú hodnotu závislú od implementácie; tento sentinel vždy kontrolujte. Veľká pozícia sa nemusí zmestiť do long; na zachovanie viacbajtového stavu použite fgetpos a fsetpos.
Príklady
#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;}
Výsledok
5 2 C
Príklad zapíše päť bajtov `ABCDE` do binárneho dočasného súboru, takže prvý `ftell` dá `5`. Po `fseek(..., 2L, SEEK_SET)` druhý dá `2` a nasledujúce čítanie získa `C`; program vytlačí `5 2 C`.