CKTIS / C
fgetpos — funkcija toka C23
`fgetpos(stream, pos)` iz `<stdio.h>` sprema trenutačno stanje položaja otvorenog toka u objekt `fpos_t` koji označava `pos`. Vraća nulu pri uspjehu i nenultu vrijednost pri pogrešci; stanje je namijenjeno kasnijem `fsetpos`.
Verzija: C23
Sintaksa
int fgetpos(FILE * restrict stream, fpos_t * restrict pos);fgetpos(stream, pos) iz <stdio.h> sprema trenutačno stanje položaja otvorenog toka u objekt fpos_t koji označava pos. Vraća nulu pri uspjehu i nenultu vrijednost pri pogrešci; stanje je namijenjeno kasnijem fsetpos.
Primjer piše ABC, čita A, sprema položaj s fgetpos, čita B, vraća ga s fsetpos i ponovno čita B. 1 B B pokazuje točno hvatanje i vraćanje stanja.
fpos_t ne mora biti aritmetički tip ni broj bajtova; može sadržavati stanje višebajtne analize. Ne računaj s njim i ne serializiraj ga kao prenosivi offset. Oba pokazivača moraju biti valjana i pos živ do uporabe. Pri pogrešci rezultat je nenult, a implementacija sprema pozitivnu vrijednost u errno.
Primjeri
#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;
}
Rezultat
1 B B
Primjer piše `ABC`, čita `A`, sprema položaj s `fgetpos`, čita `B`, vraća ga s `fsetpos` i ponovno čita `B`. `1 B B` pokazuje točno hvatanje i vraćanje stanja.