Ftell

From aldeid
Jump to navigation Jump to search

Syntax

long int ftell ( FILE * stream );

Description

Get current position in stream

Returns the current value of the position indicator of the stream.

For binary streams, this is the number of bytes from the beginning of the file.

For text streams, the numerical value may not be meaningful but can still be used to restore the position to the same position later using fseek (if there are characters put back using ungetc still pending of being read, the behavior is undefined).

Parameters

stream
Pointer to a FILE object that identifies the stream.

Return Value

On success, the current value of the position indicator is returned.

On failure, -1L is returned, and errno is set to a system-specific positive value.

Example

INCOMPLETE SECTION OR ARTICLE
This section/article is being written and is therefore not complete.
Thank you for your comprehension.