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

W przypadku powodzenia fsetpos zwraca wartość 0. Po awarii funkcja zwraca wartość niezerową i ustawia errno jedną z następujących stałych manifestu (zdefiniowaną w ERRNO. H): EBADF, co oznacza, że plik nie jest dostępny lub obiekt, który stream wskazuje, 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 Walidacja 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 stream wartości pos, która jest uzyskiwana w poprzednim wywołaniu względem fgetposstream. Funkcja czyści wskaźnik końca pliku i cofa wszelkie skutki operacji ungetc na stream. Po wywołaniu metody fsetpos, następną operacją stream może być dane wejściowe lub wyjściowe.

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

Wymagania

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

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

Przykład

Zobacz przykład dla .fgetpos

Zobacz też

We/Wy strumienia
fgetpos