WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

ftell — C23-Datenstromfunktion

`ftell(stream)` aus `<stdio.h>` ermittelt den aktuellen Dateipositionsanzeiger. Beim Binärstrom zählt das Ergebnis Zeichen ab Dateianfang; beim Textstrom ist es undurchsichtige Information, die mit `SEEK_SET` an `fseek` übergeben wird, um dieselbe Position wiederherzustellen.

Version: C23

Syntax

long int ftell(FILE *stream);

ftell(stream) aus <stdio.h> ermittelt den aktuellen Dateipositionsanzeiger. Beim Binärstrom zählt das Ergebnis Zeichen ab Dateianfang; beim Textstrom ist es undurchsichtige Information, die mit SEEK_SET an fseek übergeben wird, um dieselbe Position wiederherzustellen.

Das Beispiel schreibt fünf Bytes ABCDE in eine binäre temporäre Datei, daher liefert das erste ftell den Wert 5. Nach fseek(..., 2L, SEEK_SET) liefert das zweite 2, der nächste Lesezugriff C; Ausgabe ist 5 2 C.

Die Differenz zweier Werte eines Textstroms muss nicht die Zahl gelesener oder geschriebener Zeichen messen. Bei Fehler liefert die Funktion -1L und setzt errno auf einen positiven implementierungsabhängigen Wert; diesen Sentinel immer prüfen. Eine große Position passt eventuell nicht in long; für zusätzlichen Mehrbytezustand sind fgetpos und fsetpos besser.

Beispiele

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

Ergebnis

5 2 C

Das Beispiel schreibt fünf Bytes `ABCDE` in eine binäre temporäre Datei, daher liefert das erste `ftell` den Wert `5`. Nach `fseek(..., 2L, SEEK_SET)` liefert das zweite `2`, der nächste Lesezugriff `C`; Ausgabe ist `5 2 C`.

Quellen