CKTIS / C
ftell — функция за поток в C23
`ftell(stream)` от `<stdio.h>` получава текущия индикатор за позиция. За двоичен поток резултатът брои знаци от началото на файла; за текстов поток е непрозрачна информация, която се подава на `fseek` с `SEEK_SET` за връщане на същата позиция.
Версия: C23
Синтаксис
long int ftell(FILE *stream);ftell(stream) от <stdio.h> получава текущия индикатор за позиция. За двоичен поток резултатът брои знаци от началото на файла; за текстов поток е непрозрачна информация, която се подава на fseek с SEEK_SET за връщане на същата позиция.
Примерът записва пет байта ABCDE в двоичен временен файл, затова първият ftell дава 5. След fseek(..., 2L, SEEK_SET) вторият дава 2, а следващото четене получава C; програмата печата 5 2 C.
Разликата между две стойности за текстов поток не е непременно брой прочетени или записани знаци. При грешка функцията връща -1L и пази в errno положителна стойност, зависеща от реализацията; винаги проверявайте този sentinel. Голяма позиция може да не се побере в long; за запазване и на многобайтовото състояние използвайте fgetpos и fsetpos.
Примери
#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;}
Резултат
5 2 C
Примерът записва пет байта `ABCDE` в двоичен временен файл, затова първият `ftell` дава `5`. След `fseek(..., 2L, SEEK_SET)` вторият дава `2`, а следващото четене получава `C`; програмата печата `5 2 C`.