Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fsetpos — funkcja strumieniowa C23

`fsetpos(stream, pos)` z `<stdio.h>` odtwarza wskaźnik pozycji pliku oraz obiekt `mbstate_t`, jeśli istnieje, z wartości zapisanej wcześniej przez udane `fgetpos` dla strumienia związanego z tym samym plikiem. Zwraca `0` przy powodzeniu, a wartość niezerową przy błędzie.

Wersja: C23

Składnia

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

fsetpos(stream, pos) z <stdio.h> odtwarza wskaźnik pozycji pliku oraz obiekt mbstate_t, jeśli istnieje, z wartości zapisanej wcześniej przez udane fgetpos dla strumienia związanego z tym samym plikiem. Zwraca 0 przy powodzeniu, a wartość niezerową przy błędzie.

Przykład zapisuje ABCDE, zachowuje pozycję po AB, dochodzi do końca i obserwuje feof == 1. Następnie fsetpos przywraca zapisany stan; wynik 1 0 C pokazuje skasowanie EOF i ponowny odczyt C z właściwego miejsca.

Udane wywołanie usuwa skutki ungetc, kasuje wskaźnik końca pliku i pozwala, by następną operacją strumienia aktualizującego był odczyt albo zapis. fpos_t jest nieprzezroczysty: nie wykonuj na nim arytmetyki ani nie przenoś wartości między innymi plikami. Przy błędzie ustawiany jest wskaźnik błędu strumienia, funkcja zwraca niezero i zapisuje dodatnie, zależne od implementacji errno.

Przykłady

#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF){fclose(stream);return 1;}rewind(stream);if(fgetc(stream)!='A'||fgetc(stream)!='B'){fclose(stream);return 1;}fpos_t pos;if(fgetpos(stream,&pos)!=0){fclose(stream);return 1;}while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fsetpos(stream,&pos)!=0){fclose(stream);return 1;}int after=feof(stream)!=0,character=fgetc(stream);printf("%d %d %c\n",before,after,character);return fclose(stream)==0?0:1;}

Wynik

1 0 C

Przykład zapisuje `ABCDE`, zachowuje pozycję po `AB`, dochodzi do końca i obserwuje `feof == 1`. Następnie `fsetpos` przywraca zapisany stan; wynik `1 0 C` pokazuje skasowanie EOF i ponowny odczyt `C` z właściwego miejsca.

Źródła