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 stream pos 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 stream poswartości , która jest uzyskiwana w poprzednim wywołaniu względem fgetpos streamelementu . 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.