Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

fgetpos — funkcija toka C23

`fgetpos(stream, pos)` iz `<stdio.h>` shrani trenutno stanje položaja odprtega toka v objekt `fpos_t`, ki ga označuje `pos`. Ob uspehu vrne nič, ob napaki neničelno vrednost; stanje je namenjeno poznejšemu `fsetpos`.

Različica: C23

Sintaksa

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

fgetpos(stream, pos) iz <stdio.h> shrani trenutno stanje položaja odprtega toka v objekt fpos_t, ki ga označuje pos. Ob uspehu vrne nič, ob napaki neničelno vrednost; stanje je namenjeno poznejšemu fsetpos.

Primer zapiše ABC, prebere A, shrani položaj z fgetpos, prebere B, ga obnovi z fsetpos in znova prebere B. 1 B B pokaže natančen zajem in obnovitev stanja.

fpos_t ni nujno aritmetični tip ali število bajtov; lahko vsebuje stanje večbajtnega razčlenjevanja. Ne računajte z njim in ga ne serializirajte kot prenosljiv odmik. Oba kazalca morata biti veljavna in pos živ do uporabe. Ob napaki je rezultat neničeln, izvedba pa shrani pozitivno vrednost v errno.

Primeri

#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

Primer zapiše `ABC`, prebere `A`, shrani položaj z `fgetpos`, prebere `B`, ga obnovi z `fsetpos` in znova prebere `B`. `1 B B` pokaže natančen zajem in obnovitev stanja.

Viri