ftell(), ftello(), ftello64()

Вернуть текущую позицию указателя положения в потоке

Прототип:

#include <stdio.h>
long int ftell( FILE *fp );
off_t ftello( FILE *fp );
off64_t ftello64( FILE *fp );

Аргументы:

fp
Поток, для которого нужно вернуть текущую позицию.

Библиотека:

libc

Описание:

Функции ftell(), ftello() и ftello64() возвращают текущую позицию в потоке, определенном fp. Эта позиция определяет символ, который будет прочитан или записан следующей опреацией ввода/вывода в файл. Различия между этими функциями - в типе данных возвращаемой позиции.

Можно использовать значение, возвращаемое функцией ftell(), в последующем вызове fseek(), fseeko() или fseeko64() для восстановления предыдущего значения позиции в файле.

Возвращаемое значение:

Текущая позиция в файле. Если возникла ошибка, функция возвращает -1L, код ошибки записывается в errno.

Примеры:

#include <stdio.h>
#include <stdlib.h>
long filesize( FILE *fp )
{
long int save_pos;
long size_of_file;
/* Save the current position. */
save_pos = ftell( fp );
/* Jump to the end of the file. */
fseek( fp, 0L, SEEK_END );
/* Get the end position. */
size_of_file = ftell( fp );
/* Jump back to the original position. */
fseek( fp, save_pos, SEEK_SET );
return (size_of_file);
}
int main( void )
{
FILE *fp;
fp = fopen( "file", "r" );
if ( fp != NULL )
{
printf( "File size=%ld\n", filesize( fp ) );
fclose( fp );
return (EXIT_SUCCESS);
}
return (EXIT_FAILURE);
}

Классификация:

ftell() — ANSI, POSIX 1003.1; ftello() — POSIX 1003.1; ftello64() — Поддержка больших файлов

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

errno, fgetpos(), fopen(), fsetpos(), fseek(), fseeko(), fseeko64()




Предыдущий раздел: Описание API системной библиотеки