CKTIS / C
feof — função de fluxo C23
`feof(stream)` de `<stdio.h>` testa o indicador de fim de ficheiro de um fluxo `FILE` aberto. Devolve valor não zero se e só se esse indicador estiver definido; não lê dados nem devolve por si a constante `EOF`.
Versão: C23
Sintaxe
int feof(FILE *stream);feof(stream) de <stdio.h> testa o indicador de fim de ficheiro de um fluxo FILE aberto. Devolve valor não zero se e só se esse indicador estiver definido; não lê dados nem devolve por si a constante EOF.
O exemplo escreve um caráter num tmpfile(), rebobina, lê o caráter e observa feof == 0. Só o fgetc seguinte devolve EOF e define o indicador; 0 1 0 0 mostra também ausência de erro e o estado limpo por clearerr.
feof não prevê o fim: um ciclo deve primeiro testar o resultado da operação de entrada e depois usar feof e ferror para diagnosticar a paragem. Ler corretamente o último byte ainda não define o indicador. stream tem de ser um fluxo aberto válido; clearerr, rewind e um reposicionamento bem-sucedido podem limpar o estado EOF.
Exemplos
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputc('A', stream) == EOF) { fclose(stream); return 1; }
rewind(stream);
if (fgetc(stream) != 'A') { fclose(stream); return 1; }
int before = feof(stream) != 0;
if (fgetc(stream) != EOF) { fclose(stream); return 1; }
int after = feof(stream) != 0;
int failed = ferror(stream) != 0;
clearerr(stream);
printf("%d %d %d %d\n", before, after, failed, feof(stream) != 0);
return fclose(stream) == 0 ? 0 : 1;
}
Resultado
0 1 0 0
O exemplo escreve um caráter num `tmpfile()`, rebobina, lê o caráter e observa `feof == 0`. Só o `fgetc` seguinte devolve `EOF` e define o indicador; `0 1 0 0` mostra também ausência de erro e o estado limpo por `clearerr`.