Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

ftell — função de fluxo C23

`ftell(stream)` de `<stdio.h>` obtém o indicador de posição atual. Num fluxo binário o resultado conta caracteres desde o início; num fluxo de texto é informação opaca que pode ser passada a `fseek` com `SEEK_SET` para regressar à mesma posição.

Versão: C23

Sintaxe

long int ftell(FILE *stream);

ftell(stream) de <stdio.h> obtém o indicador de posição atual. Num fluxo binário o resultado conta caracteres desde o início; num fluxo de texto é informação opaca que pode ser passada a fseek com SEEK_SET para regressar à mesma posição.

O exemplo escreve cinco bytes ABCDE num ficheiro temporário binário, por isso o primeiro ftell dá 5. Após fseek(..., 2L, SEEK_SET), o segundo dá 2 e a leitura seguinte obtém C; o programa imprime 5 2 C.

A diferença entre dois valores de um fluxo de texto não tem de medir caracteres lidos ou escritos. Na falha a função devolve -1L e guarda em errno um valor positivo dependente da implementação; verifica sempre esse sentinel. Uma posição grande pode não caber em long; prefere fgetpos e fsetpos se também for preciso preservar o estado multibyte.

Exemplos

#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

O exemplo escreve cinco bytes `ABCDE` num ficheiro temporário binário, por isso o primeiro `ftell` dá `5`. Após `fseek(..., 2L, SEEK_SET)`, o segundo dá `2` e a leitura seguinte obtém `C`; o programa imprime `5 2 C`.

Fontes