ftell

Aus RAD Studio
Wechseln zu: Navigation, Suche

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:

EBADF

Bad file pointer (Ungültiger Dateizeiger)

ESPIPE

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++

+

+

+

+