Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

ftell — fonction de flux C23

`ftell(stream)` de `<stdio.h>` obtient l’indicateur courant de position. Pour un flux binaire, le résultat compte les caractères depuis le début ; pour un flux texte, c’est une information opaque à fournir à `fseek` avec `SEEK_SET` afin de retrouver la même position.

Version : C23

Syntaxe

long int ftell(FILE *stream);

ftell(stream) de <stdio.h> obtient l’indicateur courant de position. Pour un flux binaire, le résultat compte les caractères depuis le début ; pour un flux texte, c’est une information opaque à fournir à fseek avec SEEK_SET afin de retrouver la même position.

L’exemple écrit cinq octets ABCDE dans un fichier temporaire binaire ; le premier ftell donne donc 5. Après fseek(..., 2L, SEEK_SET), le second donne 2 et la lecture suivante obtient C ; le programme affiche 5 2 C.

La différence entre deux valeurs d’un flux texte ne mesure pas nécessairement les caractères lus ou écrits. En cas d’échec, la fonction renvoie -1L et place une valeur positive dépendant de l’implémentation dans errno ; testez toujours cette sentinelle. Une grande position peut dépasser long ; préférez fgetpos et fsetpos si l’état multioctet doit aussi être conservé.

Exemples

#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;}

Résultat

5 2 C

L’exemple écrit cinq octets `ABCDE` dans un fichier temporaire binaire ; le premier `ftell` donne donc `5`. Après `fseek(..., 2L, SEEK_SET)`, le second donne `2` et la lecture suivante obtient `C` ; le programme affiche `5 2 C`.

Sources