Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

fgetpos — proudová funkce C23

`fgetpos(stream, pos)` z `<stdio.h>` uloží aktuální stav pozice otevřeného proudu do objektu `fpos_t` určeného ukazatelem `pos`. Při úspěchu vrací nulu, při chybě nenulovou hodnotu; stav je určen pro pozdější `fsetpos`.

Verze: C23

Syntaxe

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

fgetpos(stream, pos) z <stdio.h> uloží aktuální stav pozice otevřeného proudu do objektu fpos_t určeného ukazatelem pos. Při úspěchu vrací nulu, při chybě nenulovou hodnotu; stav je určen pro pozdější fsetpos.

Příklad zapíše ABC, přečte A, uloží pozici pomocí fgetpos, přečte B, obnoví ji pomocí fsetpos a znovu přečte B. 1 B B ukazuje přesné zachycení a obnovení stavu.

fpos_t nemusí být aritmetický typ ani počet bajtů; může obsahovat stav vícebajtové analýzy. Neprovádějte s ním aritmetiku ani jej neserializujte jako přenositelný offset. Oba ukazatele musí být platné a pos musí přežít do použití. Při chybě je výsledek nenulový a implementace uloží kladnou hodnotu do errno.

Příklady

#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;
}

Výsledek

1 B B

Příklad zapíše `ABC`, přečte `A`, uloží pozici pomocí `fgetpos`, přečte `B`, obnoví ji pomocí `fsetpos` a znovu přečte `B`. `1 B B` ukazuje přesné zachycení a obnovení stavu.

Zdroje