Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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_errlist
i _sys_nerr
.
Uwagi
Funkcja fsetpos
ustawia wskaźnik pozycji pliku dla stream
pos
wartości , która jest uzyskiwana w poprzednim wywołaniu względem fgetpos
stream
elementu . Funkcja czyści wskaźnik końca pliku i cofa wszelkie skutki operacji ungetc
na stream
. Po wywołaniu metody do fsetpos
elementu 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
.