Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

fgetpos — funzione di flusso C23

`fgetpos(stream, pos)` di `<stdio.h>` salva lo stato di posizione corrente di uno stream aperto nell’oggetto `fpos_t` indicato da `pos`. Restituisce zero al successo e un valore diverso da zero all’errore; lo stato serve a un successivo `fsetpos`.

Versione: C23

Sintassi

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

fgetpos(stream, pos) di <stdio.h> salva lo stato di posizione corrente di uno stream aperto nell’oggetto fpos_t indicato da pos. Restituisce zero al successo e un valore diverso da zero all’errore; lo stato serve a un successivo fsetpos.

L’esempio scrive ABC, legge A, salva la posizione con fgetpos, legge B, la ripristina con fsetpos e legge di nuovo B. 1 B B mostra cattura e ripristino esatti dello stato.

fpos_t non deve essere aritmetico né contare byte; può includere stato di analisi multibyte. Non farvi aritmetica e non serializzarlo come offset portabile. Entrambi i puntatori devono essere validi e pos restare vivo. In caso di errore il risultato è nonzero e l’implementazione salva un valore positivo in errno.

Esempi

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

Risultato

1 B B

L’esempio scrive `ABC`, legge `A`, salva la posizione con `fgetpos`, legge `B`, la ripristina con `fsetpos` e legge di nuovo `B`. `1 B B` mostra cattura e ripristino esatti dello stato.

Fonti