CKTIS / C
ftell — proudová funkce C23
`ftell(stream)` z `<stdio.h>` získá aktuální ukazatel pozice. Pro binární proud výsledek počítá znaky od začátku souboru; pro textový proud jde o neprůhlednou informaci předatelnou `fseek` s `SEEK_SET` pro návrat na stejnou pozici.
Verze: C23
Syntaxe
long int ftell(FILE *stream);ftell(stream) z <stdio.h> získá aktuální ukazatel pozice. Pro binární proud výsledek počítá znaky od začátku souboru; pro textový proud jde o neprůhlednou informaci předatelnou fseek s SEEK_SET pro návrat na stejnou pozici.
Příklad zapíše pět bajtů ABCDE do binárního dočasného souboru, takže první ftell dá 5. Po fseek(..., 2L, SEEK_SET) druhý dá 2 a následující čtení získá C; program vytiskne 5 2 C.
Rozdíl dvou hodnot textového proudu nemusí měřit počet přečtených či zapsaných znaků. Při chybě funkce vrátí -1L a uloží do errno kladnou hodnotu závislou na implementaci; tento sentinel vždy kontrolujte. Velká pozice se nemusí vejít do long; pro zachování vícebajtového stavu použijte fgetpos a fsetpos.
Pří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ýsledek
5 2 C
Příklad zapíše pět bajtů `ABCDE` do binárního dočasného souboru, takže první `ftell` dá `5`. Po `fseek(..., 2L, SEEK_SET)` druhý dá `2` a následující čtení získá `C`; program vytiskne `5 2 C`.