CKTIS / C
ftell — función de flujo de C23
`ftell(stream)` de `<stdio.h>` obtiene el indicador de posición actual. En un flujo binario el resultado cuenta caracteres desde el principio; en uno de texto es información opaca que puede pasarse a `fseek` con `SEEK_SET` para volver a la misma posición.
Versión: C23
Sintaxis
long int ftell(FILE *stream);ftell(stream) de <stdio.h> obtiene el indicador de posición actual. En un flujo binario el resultado cuenta caracteres desde el principio; en uno de texto es información opaca que puede pasarse a fseek con SEEK_SET para volver a la misma posición.
El ejemplo escribe cinco bytes ABCDE en un archivo temporal binario, por lo que el primer ftell da 5. Tras fseek(..., 2L, SEEK_SET), el segundo da 2 y la siguiente lectura obtiene C; el programa muestra 5 2 C.
La diferencia entre dos valores de un flujo de texto no tiene que medir caracteres leídos o escritos. Al fallar devuelve -1L y guarda en errno un valor positivo dependiente de la implementación; comprueba siempre ese sentinel. Una posición grande puede no caber en long; usa fgetpos y fsetpos si también hay que preservar el estado multibyte.
Ejemplos
#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;}
Resultado
5 2 C
El ejemplo escribe cinco bytes `ABCDE` en un archivo temporal binario, por lo que el primer `ftell` da `5`. Tras `fseek(..., 2L, SEEK_SET)`, el segundo da `2` y la siguiente lectura obtiene `C`; el programa muestra `5 2 C`.