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