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.