====== ftell ======

===== Description =====

Get the current position in a file stream.

===== Function prototype =====

<code>
int64 ftell <voidptr:hFile>
</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| hFile | voidptr | A handle to a file, the current stream position of which is to be determined. |

===== Return value =====

===== Example =====

<code>
voidptr fp
set fp <zs:fopen "c:\\test.txt" "w">
assert fp "Cannot open file!"

string s
set s "Hello!"
fwrite fp s

echo <zs:ftell fp> // write the current file position to the event log

fclose fp
</code>

... the output of which is written to the event log by [[plugins:general:zeoscript:reference:functions:echo]] as:

<file>
6
</file>

===== Comments =====

None.


===== See also =====

  * [[plugins:general:zeoscript:reference:functions:fopen]]
  * [[plugins:general:zeoscript:reference:functions:fopen_s]]
  * [[plugins:general:zeoscript:reference:functions:fclose]]
  * [[plugins:general:zeoscript:reference:functions:fread]]
  * [[plugins:general:zeoscript:reference:functions:fwrite]]
  * [[plugins:general:zeoscript:reference:functions:fgetc]]
  * [[plugins:general:zeoscript:reference:functions:fputc]]
  * [[plugins:general:zeoscript:reference:functions:fseek]]
  * [[plugins:general:zeoscript:reference:functions:rewind]]