Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

fsetpos — funzione di flusso C23

`fsetpos(stream, pos)` di `<stdio.h>` ripristina l’indicatore di posizione e, se presente, l’oggetto `mbstate_t` da un valore salvato da `fgetpos` riuscito su uno stream associato allo stesso file. Restituisce `0` al successo e un valore nonzero all’errore.

Versione: C23

Sintassi

int fsetpos(FILE *stream, const fpos_t *pos);

fsetpos(stream, pos) di <stdio.h> ripristina l’indicatore di posizione e, se presente, l’oggetto mbstate_t da un valore salvato da fgetpos riuscito su uno stream associato allo stesso file. Restituisce 0 al successo e un valore nonzero all’errore.

L’esempio scrive ABCDE, salva la posizione dopo AB, legge fino alla fine e osserva feof == 1. Poi fsetpos ripristina lo stato; 1 0 C mostra che EOF è cancellato e C viene riletto dalla posizione voluta.

Il successo annulla gli effetti di ungetc, cancella l’indicatore di fine e consente poi input o output su uno stream di aggiornamento. fpos_t è opaco: niente aritmetica né trasferimento tra file. Se lettura o scrittura fallisce viene impostato l’indicatore di errore; la funzione restituisce nonzero e salva in errno un valore positivo dipendente dall’implementazione.

Esempi

#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF){fclose(stream);return 1;}rewind(stream);if(fgetc(stream)!='A'||fgetc(stream)!='B'){fclose(stream);return 1;}fpos_t pos;if(fgetpos(stream,&pos)!=0){fclose(stream);return 1;}while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fsetpos(stream,&pos)!=0){fclose(stream);return 1;}int after=feof(stream)!=0,character=fgetc(stream);printf("%d %d %c\n",before,after,character);return fclose(stream)==0?0:1;}

Risultato

1 0 C

L’esempio scrive `ABCDE`, salva la posizione dopo `AB`, legge fino alla fine e osserva `feof == 1`. Poi `fsetpos` ripristina lo stato; `1 0 C` mostra che EOF è cancellato e `C` viene riletto dalla posizione voluta.

Fonti