ftell

[funkcja] Zwraca aktualną pozycję kursora odczytu/zapisu danych dla wskazanego strumienia.

Składnia

#include <cstdio>

long ftell( FILE * stream );

Argumenty

Argument	Opis
FILE *stream	Określa strumień na którym ma zostać wykonana operacja.

Zwracana wartość

Zwraca aktualną pozycję kursora odczytu/zapisu danych w przypadku sukcesu. Funkcja zwraca wartość -1L w przypadku wystąpienia błędu.

Opis szczegółowy

Funkcja zwraca aktualną pozycję kursora odczytu/zapisu danych dla wskazanego strumienia.

Dla strumieni danych otwartych w trybie binarnym, pozycja kursora określa numer bajta na który wskazuje kursor, licząc od początku pliku.

W przypadku strumieni tekstowych, pozycja kursora może nie odzwierciedlać fizycznej numeracji bajtów, ponieważ w strumieniach tekstowych znaki przejścia do nowej linii zazwyczaj podlegają transformacjom.

Do przywrócenia pozycji kursora (otrzymanej przy pomocy funkcji fteel) należy użyć funkcji _{» standard C ♦}fseek.

Dodatkowe informacje

Niektóre implementacje standardowych bibliotek C++ w przypadku wystąpienia błędu ustawiają dodatkowo kod błędu _{» standard C ♦}errno. Standard nie definiuje jednak tego zachowania, więc ewentualne ustawiane kody błędów należy weryfikować w dokumentacji zgodnej z posiadanym kompilatorem.

Przykład

#include <cstdio>

int main()
{
FILE * plik = fopen( "plik.txt", "rb" );
if( plik != NULL )
{
fseek( plik, 0, SEEK_END );
long odczytanaPozycja = ftell( plik );
fclose( plik );
printf( "Plik ma rozmiar: %ld bajtow.\n", odczytanaPozycja );
}
return 0;
}

Zagadnienia powiązane

fseek	Ustawia lub przesuwa pozycję kursora odczytu/zapisu danych dla wskazanego strumienia. (funkcja)
fgetpos	Pobiera aktualną pozycję kursora odczytu/zapisu danych dla wskazanego strumienia. (funkcja)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.