CKTIS / C
ftell — funkcija toka C23
`ftell(stream)` iz `<stdio.h>` pridobi trenutni kazalnik položaja. Pri binarnem toku rezultat šteje znake od začetka datoteke; pri besedilnem toku je to nepregledna informacija, ki jo z `SEEK_SET` podate `fseek` za vrnitev na isti položaj.
Različica: C23
Sintaksa
long int ftell(FILE *stream);ftell(stream) iz <stdio.h> pridobi trenutni kazalnik položaja. Pri binarnem toku rezultat šteje znake od začetka datoteke; pri besedilnem toku je to nepregledna informacija, ki jo z SEEK_SET podate fseek za vrnitev na isti položaj.
Primer zapiše pet bajtov ABCDE v binarno začasno datoteko, zato prvi ftell vrne 5. Po fseek(..., 2L, SEEK_SET) drugi vrne 2, naslednje branje pa C; program izpiše 5 2 C.
Razlika dveh vrednosti besedilnega toka ni nujno mera prebranih ali zapisanih znakov. Ob napaki funkcija vrne -1L in v errno shrani pozitivno od izvedbe odvisno vrednost; ta sentinel vedno preverite. Velik položaj morda ne gre v long; za ohranitev večbajtnega stanja uporabite fgetpos in fsetpos.
Primeri
#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;}
Rezultat
5 2 C
Primer zapiše pet bajtov `ABCDE` v binarno začasno datoteko, zato prvi `ftell` vrne `5`. Po `fseek(..., 2L, SEEK_SET)` drugi vrne `2`, naslednje branje pa `C`; program izpiše `5 2 C`.