fseek

[funkcja] Ustawia lub przesuwa pozycję kursora odczytu/zapisu danych dla wskazanego strumienia.

Składnia

#include <cstdio>

int fseek( FILE * stream, long offset, int origin );

Argumenty

Argument Opis

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

long offset Wartość określająca o ile bajtów należy przesunąć kursor odczytu/zapisu danych. Pozycja względem której wykonywane będzie przesunięcie kursora jest określana za pomocą argumentu origin.

int origin

Argument może przyjmować jedną z poniższych wartości:

Wartość	Opis
SEEK_SET	Przesunięcie kursora jest wyrażone względem początku pliku.
SEEK_CUR	Przesunięcie kursora jest wyrażane względem aktualnej pozycji.
SEEK_END	Przesunięcie kursora jest wyrażone względem końca pliku.

Zwracana wartość

Zwraca wartość zero w przypadku sukcesu. W przeciwnym wypadku funkcja zwraca wartość różną od zera.

Opis szczegółowy

Funkcja ustawia lub przesuwa pozycję kursora odczytu/zapisu danych dla wskazanego strumienia.

Dla strumienia otwartego w trybie binarnym, nowa pozycja kursora jest ustalana poprzez dodanie wartości offset do pozycji, którą określa argument origin.

Dla strumienia otwartego w trybie tekstowym, wartość argumentu offset powinna wynosić zero lub wartość argumentu offset powinna być uprzednio pobrana za pomocą funkcji _{» standard C ♦}ftell, a następnie użyta w połączeniu z origin ustawionym na wartość SEEK_SET.

Flaga osiągnięcia końca pliku jest czyszczona, jeżeli wywołanie tej funkcji zakończyło się sukcesem. W przypadku sukcesu funkcja ta odrzuca również wszelkie zmiany spowodowane wywołaniem funkcji _{» standard C ♦}ungetc.

Przykład

#include <cstdio>

int main()
{
FILE * plik = fopen( "plik.out", "w+" );
if( plik != NULL )
{
fprintf( plik, "To jest prosty przyklad.\n" );

int czyBlad = fseek( plik, 8, SEEK_SET );
if( czyBlad == 0 )
{
printf( "Kursor ustawiony na pozycji %d.\n", 8 );
char lancuch[ 81 ];
fgets( lancuch, 80, plik );
printf( "%s", lancuch );
} else
perror( "Blad fseek\n" );

fclose( plik );
}
return 0;
}

Standardowe wyjście programu:

Kursor ustawiony na pozycji 8.
prosty przyklad.

Zagadnienia powiązane

ftell	Zwraca aktualną pozycję kursora odczytu/zapisu danych dla wskazanego strumienia. (funkcja)
fsetpos	Ustawia pozycję kursora odczytu/zapisu danych dla wskazanego strumienia. (funkcja)
rewind	Przesuwa kursor odczytu/zapisu danych na początek 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.