ftell, ftello, ftell64, ftello64 - Aktuelle Position des Lese-/Schreibzeigers ermitteln

Definition	#include <stdio.h> long ftell(FILE *dz); off_t ftello(FILE *dz); long long ftell64(FILE *dz); off64_t ftello64(FILE *dz); ftell/ftello und ftell64/ftello64 liefern die aktuelle Position des Lese-/Schreibzeigers für die Datei mit Dateizeiger dz. ftell/ftello und ftell64/ftello64 lassen sich auf Binärdateien (SAM im Binärmodus, PAM, INCORE) und Textdateien (SAM im Textmodus, ISAM) anwenden. Für die Bearbeitung von Dateien > 2 GB verfahren Sie wie folgt: Falls das Define _FILE_OFFSET_BITS 64 (siehe "Unterstützung von DVS- und UFS-Dateien > 2 GB") gesetzt ist, rufen Sie ftello auf. Implizit wird dann ftello64 mit den passenden Parametern verwendet. Andernfalls müssen Sie ftell64 bzw. ftello64 aufrufen. Es besteht kein funktionaler Unterschied zwischen ftell und ftell64 bzw. ftello und ftello64. Die Funktionen unterscheiden sich nur hinsichtlich des für den Rückgabewert verwendeten Offset-Typs.
Returnwert	Position in der Datei bei Erfolg, und zwar
		bei Binärdateien die Anzahl Bytes, die der Lese-/Schreibzeiger vom Dateianfang entfernt ist, bei Textdateien die absolute Position des Lese-/Schreibzeigers.
	-1	im Fehlerfall. Wenn der Wert für die Dateiposition nicht innerhalb des Wertebereichs des Rückgabetyps liegt, wird zusätzlich errno auf ERANGE gesetzt.
Hinweise	Auf die von ftell/ftello bzw. ftell64/ftello64 gelieferte Position kann mit den Funktionen fseek/fseeko bzw. fseek64/fseeko64 positioniert werden. ftell/ftello und ftell64/ftello64 sind nicht anwendbar für Systemdateien (SYSDTA, SYSLST, SYSOUT).
Beispiel	In folgendem Programm wird ab dem elften Zeichen jedes Zeichen von dat mit der Position des Lese-/Schreibzeigers ausgegeben (funktioniert nur mit Binärdateien). #include <stdio.h> int main(void) { FILE *fp; int c; if((fp = fopen("dat","rb")) != NULL) { /* die ersten 10 Zeichen werden übersprungen */ fseek(fp,10L,SEEK_SET); while((c=getc(fp)) != EOF) printf("Position : %ld, Zeichen : %c\n",ftell(fp),c); fclose(fp); } return 0; }
Siehe auch	fseek, fseek64, fgetpos, fgetpos64, ftell, ftell64, tell