Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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`.

Fontes