Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

fseek — funzione di flusso C23

`fseek(stream, offset, whence)` di `<stdio.h>` imposta la posizione del file rispetto a `SEEK_SET`, `SEEK_CUR` o `SEEK_END`. Restituisce `0` al successo e un valore nonzero all’errore; il successo cancella l’indicatore di fine file e gli effetti di `ungetc`.

Versione: C23

Sintassi

int fseek(FILE *stream, long int offset, int whence);

fseek(stream, offset, whence) di <stdio.h> imposta la posizione del file rispetto a SEEK_SET, SEEK_CUR o SEEK_END. Restituisce 0 al successo e un valore nonzero all’errore; il successo cancella l’indicatore di fine file e gli effetti di ungetc.

L’esempio scrive ABCDE, avanza di due byte da SEEK_SET e legge C. Poi raggiunge la fine, osserva feof == 1, torna all’inizio e stampa C 1 0, dimostrando che il posizionamento riuscito cancella EOF.

Su uno stream binario l’offset è in byte, ma SEEK_END può non essere supportato. Per uno stream testuale sono portabili solo offset 0 o un precedente valore di ftell con SEEK_SET. Dopo un errore la posizione può essere indeterminata; non posizionare stream che non supportano l’operazione.

Esempi

#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF||fseek(stream,2L,SEEK_SET)!=0){fclose(stream);return 1;}int selected=fgetc(stream);while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fseek(stream,0L,SEEK_SET)!=0){fclose(stream);return 1;}int after=feof(stream)!=0;printf("%c %d %d\n",selected,before,after);return fclose(stream)==0?0:1;}

Risultato

C 1 0

L’esempio scrive `ABCDE`, avanza di due byte da `SEEK_SET` e legge `C`. Poi raggiunge la fine, osserva `feof == 1`, torna all’inizio e stampa `C 1 0`, dimostrando che il posizionamento riuscito cancella EOF.

Fonti