====== ftell() ======

''ftell()'' ist in der ''[[c:lib:stdio:start|stdio]]'' definiert, die in C über ''stdio.h'', bzw in C++ über ''cstdio'' eingebunden wird.


===== Funktion =====

''ftell()'' dient dazu die aktuelle Schreibe/Lese-Position in der angegebenen Datei bzw. im angegebenem Stream zu ermitteln.


===== Signatur =====

<code cpp>#include <stdio.h>
long int ftell(FILE *file);</code>
**file**: Gültiger Zeiger auf FILE Element\\
\\
**Return Value** Schreib/Leseposition innerhalb der Datei

Der Rückgabewert ist nicht zwingend eine Angabe in Byte, sie kann aber in jedem Fall verwendet werden, um mit ''[[c:lib:stdio:fseek|fseek()]]'' an eine Position innerhalb der Datei zu springen.

===== Fehlerquellen =====

Es muss darauf geachtet werden, dass ein gültiger ''FILE'' Zeiger übergeben wird.

Es kann (in wirklich seltenen Fällen) vorkommen, dass der Rückgabewert keine Angabe in Byte ist. Der Wert kann aber in jedem Fall verwendet werden, um mit ''[[c:lib:stdio:fseek|fseek()]]'' an eine Position innerhalb der Datei zu springen.

===== Beispiel =====

<code cpp>
#include <stdio.h>

int main (void)
{
  FILE *file = fopen("testfile.txt", "r");
  // (...)
  long int pos = ftell(file);
  // (...)
  fclose(file);
  return pos;
}</code>

===== siehe auch =====

[[:|stdio]]: [[fseek()]], [[fgetpos()]]