std::ftell (3) - Linux Manuals

std::ftell: std::ftell

NAME

std::ftell - std::ftell

Synopsis


Defined in header <cstdio>
long ftell( std::FILE* stream );


Returns the current value of the file position indicator for the file stream stream.
If the stream is open in binary mode, the value obtained by this function is the number of bytes from the beginning of the file.
If the stream is open in text mode, the value returned by this function is unspecified and is only meaningful as the input to std::fseek

Parameters


stream - file stream to examine

Return value


File position indicator on success or -1L if failure occurs. Also sets errno on failure.

Example


 This section is incomplete
 Reason: no example

See also


        gets the file position indicator
fgetpos (function)
        moves the file position indicator to a specific location in a file
fseek (function)
        moves the file position indicator to a specific location in a file
fsetpos (function)
        returns the input position indicator
tellg (public member function of std::basic_istream<CharT,Traits>)
        returns the output position indicator
tellp (public member function of std::basic_ostream<CharT,Traits>)