KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

fgetpos — C23-streamfunctie

`fgetpos(stream, pos)` uit `<stdio.h>` bewaart de huidige positietoestand van een open stream in het door `pos` aangewezen `fpos_t`-object. De functie retourneert nul bij succes en niet-nul bij mislukking; de toestand is bedoeld voor een latere `fsetpos`.

Versie: C23

Syntax

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

fgetpos(stream, pos) uit <stdio.h> bewaart de huidige positietoestand van een open stream in het door pos aangewezen fpos_t-object. De functie retourneert nul bij succes en niet-nul bij mislukking; de toestand is bedoeld voor een latere fsetpos.

Het voorbeeld schrijft ABC, leest A, bewaart de positie met fgetpos, leest B, herstelt met fsetpos en leest B opnieuw. 1 B B toont exact vastleggen en herstellen van de toestand.

fpos_t hoeft geen rekenkundig type of byteaantal te zijn; het kan multibyte-parsertoestand bevatten. Reken er niet mee en serialiseer het niet als draagbare offset. Beide pointers moeten geldig zijn en pos moet tot gebruik leven. Bij mislukking is het resultaat niet-nul en bewaart de implementatie een positieve waarde in errno.

Voorbeelden

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

Resultaat

1 B B

Het voorbeeld schrijft `ABC`, leest `A`, bewaart de positie met `fgetpos`, leest `B`, herstelt met `fsetpos` en leest `B` opnieuw. `1 B B` toont exact vastleggen en herstellen van de toestand.

Bronnen