Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

ftell — funzione di flusso C23

`ftell(stream)` di `<stdio.h>` ottiene l’indicatore corrente di posizione. Per uno stream binario il risultato conta i caratteri dall’inizio; per uno testuale è informazione opaca da passare a `fseek` con `SEEK_SET` per tornare alla stessa posizione.

Versione: C23

Sintassi

long int ftell(FILE *stream);

ftell(stream) di <stdio.h> ottiene l’indicatore corrente di posizione. Per uno stream binario il risultato conta i caratteri dall’inizio; per uno testuale è informazione opaca da passare a fseek con SEEK_SET per tornare alla stessa posizione.

L’esempio scrive cinque byte ABCDE in un file temporaneo binario, quindi il primo ftell dà 5. Dopo fseek(..., 2L, SEEK_SET), il secondo dà 2 e la lettura successiva ottiene C; il programma stampa 5 2 C.

La differenza tra due valori di uno stream testuale non misura necessariamente i caratteri letti o scritti. All’errore la funzione restituisce -1L e salva in errno un valore positivo dipendente dall’implementazione; controlla sempre quel sentinel. Una posizione grande può non entrare in long; preferisci fgetpos e fsetpos se va preservato anche lo stato multibyte.

Esempi

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

Risultato

5 2 C

L’esempio scrive cinque byte `ABCDE` in un file temporaneo binario, quindi il primo `ftell` dà `5`. Dopo `fseek(..., 2L, SEEK_SET)`, il secondo dà `2` e la lettura successiva ottiene `C`; il programma stampa `5 2 C`.

Fonti