CKTIS / C
fseek — função de fluxo C23
`fseek(stream, offset, whence)` de `<stdio.h>` define a posição do ficheiro relativamente a `SEEK_SET`, `SEEK_CUR` ou `SEEK_END`. Devolve `0` no sucesso e valor não zero na falha; o sucesso limpa o indicador de fim e desfaz os efeitos de `ungetc`.
Versão: C23
Sintaxe
int fseek(FILE *stream, long int offset, int whence);fseek(stream, offset, whence) de <stdio.h> define a posição do ficheiro relativamente a SEEK_SET, SEEK_CUR ou SEEK_END. Devolve 0 no sucesso e valor não zero na falha; o sucesso limpa o indicador de fim e desfaz os efeitos de ungetc.
O exemplo escreve ABCDE, avança dois bytes a partir de SEEK_SET e lê C. Depois chega ao fim, observa feof == 1, volta ao início e imprime C 1 0, demonstrando que o posicionamento bem-sucedido limpa EOF.
Num fluxo binário o deslocamento mede-se em bytes, embora SEEK_END possa não ser suportado. Para fluxo de texto só são portáveis offset 0 ou valor anterior de ftell com SEEK_SET. Após falha a posição pode ficar indeterminada; não reposiciones fluxo sem suporte para a operação.
Exemplos
#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;}
Resultado
C 1 0
O exemplo escreve `ABCDE`, avança dois bytes a partir de `SEEK_SET` e lê `C`. Depois chega ao fim, observa `feof == 1`, volta ao início e imprime `C 1 0`, demonstrando que o posicionamento bem-sucedido limpa EOF.