fsetpos

Ustawia wskaźnik położenia strumienia.

Składnia

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

Parametry

stream
Wskaźnik do FILE struktury.

pos
Magazyn wskaźnika położenia.

Wartość zwracana

Jeśli operacja powiedzie się, fsetpos zwraca wartość 0. Po awarii funkcja zwraca wartość niezerową i ustawia errno na jedną z następujących stałych manifestu (zdefiniowanych w errNO. H): EBADF, co oznacza, że plik nie jest dostępny lub obiekt wskazujący stream nie jest prawidłową strukturą plików; lub EINVAL, co oznacza nieprawidłową wartość lub streampos została przekazana. Jeśli przekazano nieprawidłowy parametr, te funkcje wywołują nieprawidłową procedurę obsługi parametrów zgodnie z opisem w temacie Weryfikacja parametrów.

Aby uzyskać więcej informacji na temat kodów zwracanych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Funkcja fsetpos ustawia wskaźnik pozycji pliku dla streamposwartości , która jest uzyskiwana w poprzednim wywołaniu względem fgetposstreamelementu . Funkcja czyści wskaźnik końca pliku i cofa wszelkie skutki operacji ungetc na stream. Po wywołaniu metody do fsetposelementu następna operacja stream może być danymi wejściowymi lub wyjściowymi.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Function	Wymagany nagłówek
fsetpos	<stdio.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

Zobacz przykład dla elementu fgetpos.

Zobacz też

We/Wy strumienia
fgetpos