CKTIS / C
fgetpos — prúdová funkcia C23
`fgetpos(stream, pos)` z `<stdio.h>` uloží aktuálny stav pozície otvoreného prúdu do objektu `fpos_t` určeného ukazovateľom `pos`. Pri úspechu vracia nulu, pri chybe nenulovú hodnotu; stav je určený pre neskorší `fsetpos`.
Verzia: C23
Syntax
int fgetpos(FILE * restrict stream, fpos_t * restrict pos);fgetpos(stream, pos) z <stdio.h> uloží aktuálny stav pozície otvoreného prúdu do objektu fpos_t určeného ukazovateľom pos. Pri úspechu vracia nulu, pri chybe nenulovú hodnotu; stav je určený pre neskorší fsetpos.
Príklad zapíše ABC, prečíta A, uloží pozíciu pomocou fgetpos, prečíta B, obnoví ju pomocou fsetpos a znova prečíta B. 1 B B ukazuje presné zachytenie a obnovenie stavu.
fpos_t nemusí byť aritmetický typ ani počet bajtov; môže obsahovať stav viacbajtovej analýzy. Nevykonávajte s ním aritmetiku ani ho neserializujte ako prenosný offset. Oba ukazovatele musia byť platné a pos musí prežiť do použitia. Pri chybe je výsledok nenulový a implementácia uloží kladnú hodnotu do errno.
Prí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ýsledok
1 B B
Príklad zapíše `ABC`, prečíta `A`, uloží pozíciu pomocou `fgetpos`, prečíta `B`, obnoví ju pomocou `fsetpos` a znova prečíta `B`. `1 B B` ukazuje presné zachytenie a obnovenie stavu.