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

CKTIS / C

fclose — função de fluxo C23

`fclose(stream)` de `<stdio.h>` descarrega o fluxo indicado, entrega os dados não escritos ao ambiente anfitrião, descarta entrada não lida, fecha o ficheiro associado e desassocia o objeto `FILE`. Devolve zero no sucesso ou `EOF` na falha.

Versão: C23

Sintaxe

int fclose(FILE *stream);

fclose(stream) de <stdio.h> descarrega o fluxo indicado, entrega os dados não escritos ao ambiente anfitrião, descarta entrada não lida, fecha o ficheiro associado e desassocia o objeto FILE. Devolve zero no sucesso ou EOF na falha.

O exemplo cria um tmpfile(), escreve os cinco bytes hello, obtém a posição com ftell e depois chama fclose. 5 1 confirma o tamanho lógico antes do fecho e um estado zero; o ficheiro temporário é então removido.

Mesmo se fclose indicar falha, o fluxo fica desassociado e não deve voltar a ser descarregado, fechado ou utilizado. Verifica o estado, pois a falha ao escrever saída em buffer pode surgir apenas no fecho. stream tem de designar um fluxo aberto; depois da chamada o ponteiro deixa de ser um handle válido.

Exemplos

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputs("hello", stream) == EOF) { fclose(stream); return 1; }
    long position = ftell(stream);
    if (position < 0) { fclose(stream); return 1; }
    int closed = fclose(stream);
    printf("%ld %d\n", position, closed == 0);
    return closed == 0 ? 0 : 1;
}

Resultado

5 1

O exemplo cria um `tmpfile()`, escreve os cinco bytes `hello`, obtém a posição com `ftell` e depois chama `fclose`. `5 1` confirma o tamanho lógico antes do fecho e um estado zero; o ficheiro temporário é então removido.

Fontes