ftell
Nach oben zu stdio.h - Index
Header-Datei
stdio.h
Kategorie
Eingabe-/Ausgaberoutinen
Prototyp
long ftell(FILE *stream); __int64 _ftelli64(FILE *stream);
Beschreibung
Gibt den aktuellen Dateizeiger zurück.
ftell gibt den aktuellen Dateizeiger für stream zurück. Dieser Wert gibt die aktuelle Position des Dateizeiger gemessen in Bytes vom Dateianfang an (wenn es sich um eine Binärdatei handelt). Der von ftell zurückgegebene Wert kann in nachfolgenden Aufrufen von fseek verwendet werden.
Rückgabewert
Wenn erfolgreich, gibt ftell die aktuelle Position des Dateizeigers zurück. Bei einem Fehler wird -1L
zurückgegeben und die globale Variable errno auf einen positiven Wert gesetzt.
Bei einem Fehler wird die globale Variable errno auf einen der folgenden Werte gesetzt:
|
Bad file pointer (Ungültiger Dateizeiger) |
|
Illegal seek on device (Ungültige Neupositionierung auf dem Gerät) |
Beispiel
#include <stdio.h> int main(void) { FILE *stream; stream = fopen("MYFILE.TXT", "w+"); fprintf(stream, "This is a test"); printf("The file pointer is at byte %ld\n", ftell(stream)); fclose(stream); return 0; }
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ |
---|---|---|---|
+ |
+ |
+ |
+ |