fsetpos

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

Składnia

#include <cstdio>

int fsetpos( FILE * stream, const fpos_t * pos );

Argumenty

Argument	Opis
FILE *stream	Określa strumień na którym ma zostać wykonana operacja.
const fpos_t* pos	Wskaźnik na zmienną, która określa nową pozycję kursora odczytu/zapisu danych, jaka ma zostać ustawiona dla wskazanego strumienia.

Zwracana wartość

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

Opis szczegółowy

Funkcja ustawia pozycję kursora odczytu/zapisu danych dla wskazanego strumienia. Nową pozycję kursora określa drugi argument funkcji.

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.

Wartość przekazywana poprzez drugi argument powinna być wcześniej pobrana przy pomocy funkcji _{» standard C ♦}fgetpos. Więcej informacji na ten temat znajdziesz w dokumentach _{» standard C ♦}fgetpos oraz _{» standard C ♦}fpos_t.

Dodatkowe informacje

Niniejsza funkcja w przypadku wystąpienia błędu ustawia dodatkowo kod błędu _{» standard C ♦}errno. Standard nie określa jednak ustawianej wartości, więc kod błędu należy weryfikować w dokumentacji zgodnej z posiadanym kompilatorem.

Przykład

#include <cstdio>

int main()
{
FILE * plik = fopen( "plik.txt", "w" );
if( plik )
{
fpos_t pozycja;
fgetpos( plik, & pozycja );
fputs( "To jest moj...", plik );
fsetpos( plik, & pozycja );
fputs( "On", plik );
fclose( plik );
}
return 0;
}

Dane zapisane w pliku tekstowym:

On jest moj...

Zagadnienia powiązane

fpos_t	Typ danych, używany do określania położenia danych w strumieniu. (alias)
fgetpos	Pobiera aktualną pozycję kursora odczytu/zapisu danych dla wskazanego strumienia. (funkcja)
fseek	Ustawia lub przesuwa 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.