Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fgetpos — funkcja strumieniowa C23

`fgetpos(stream, pos)` z `<stdio.h>` zapisuje bieżący stan pozycji otwartego strumienia w obiekcie `fpos_t` wskazanym przez `pos`. Zwraca zero przy powodzeniu, a wartość niezerową przy błędzie; zapisany stan jest przeznaczony do późniejszego `fsetpos`.

Wersja: C23

Składnia

int fgetpos(FILE * restrict stream, fpos_t * restrict pos);

fgetpos(stream, pos) z <stdio.h> zapisuje bieżący stan pozycji otwartego strumienia w obiekcie fpos_t wskazanym przez pos. Zwraca zero przy powodzeniu, a wartość niezerową przy błędzie; zapisany stan jest przeznaczony do późniejszego fsetpos.

Przykład zapisuje ABC, odczytuje A, zachowuje pozycję przez fgetpos, odczytuje B, przywraca pozycję przez fsetpos i ponownie odczytuje B. Wynik 1 B B pokazuje udany zapis i odtworzenie dokładnego stanu.

fpos_t nie musi być typem arytmetycznym ani liczbą bajtów; może zawierać stan analizy znaku wielobajtowego, więc nie wykonuj na nim działań i nie serializuj go jako przenośnego offsetu. Oba wskaźniki muszą być poprawne, a pos musi żyć do użycia. Przy błędzie wynik jest niezerowy i implementacja zapisuje dodatnią wartość do errno.

Przykłady

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputs("ABC", stream) == EOF) { fclose(stream); return 1; }
    rewind(stream);
    if (fgetc(stream) != 'A') { fclose(stream); return 1; }
    fpos_t position;
    int saved = fgetpos(stream, &position) == 0;
    int first = fgetc(stream);
    if (!saved || fsetpos(stream, &position) != 0) { fclose(stream); return 1; }
    int again = fgetc(stream);
    printf("%d %c %c\n", saved, first, again);
    return fclose(stream) == 0 ? 0 : 1;
}

Wynik

1 B B

Przykład zapisuje `ABC`, odczytuje `A`, zachowuje pozycję przez `fgetpos`, odczytuje `B`, przywraca pozycję przez `fsetpos` i ponownie odczytuje `B`. Wynik `1 B B` pokazuje udany zapis i odtworzenie dokładnego stanu.

Źródła