CKTIS / C
ftell — funkcija toka C23
`ftell(stream)` iz `<stdio.h>` dobiva trenutačni pokazatelj položaja. Za binarni tok rezultat broji znakove od početka datoteke; za tekstni tok to je neprozirna informacija koja se uz `SEEK_SET` predaje `fseek` za povratak na isti položaj.
Verzija: C23
Sintaksa
long int ftell(FILE *stream);ftell(stream) iz <stdio.h> dobiva trenutačni pokazatelj položaja. Za binarni tok rezultat broji znakove od početka datoteke; za tekstni tok to je neprozirna informacija koja se uz SEEK_SET predaje fseek za povratak na isti položaj.
Primjer piše pet bajtova ABCDE u binarnu privremenu datoteku, pa prvi ftell daje 5. Nakon fseek(..., 2L, SEEK_SET) drugi daje 2, a sljedeće čitanje C; program ispisuje 5 2 C.
Razlika dviju vrijednosti tekstnog toka ne mora mjeriti pročitane ili zapisane znakove. Pri kvaru funkcija vraća -1L i u errno sprema pozitivnu implementacijski ovisnu vrijednost; uvijek provjeri taj sentinel. Velik položaj možda ne stane u long; za očuvanje višebajtnog stanja koristi fgetpos i fsetpos.
Primjeri
#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
Primjer piše pet bajtova `ABCDE` u binarnu privremenu datoteku, pa prvi `ftell` daje `5`. Nakon `fseek(..., 2L, SEEK_SET)` drugi daje `2`, a sljedeće čitanje `C`; program ispisuje `5 2 C`.