NOME¶

fclose - fecha um fluxo

BIBLIOTECA¶

Biblioteca C Padrão (libc, -lc)

SINOPSE¶

#include <stdio.h>

int fclose(FILE *stream);

DESCRIÇÃO¶

A função fclose() libera o fluxo apontado por stream (escrevendo quaisquer dados de saída armazenados em buffer usando fflush(3)) e fecha o descritor de arquivo subjacente.

O comportamento de fclose() é indefinido se o parâmetro stream for um ponteiro ilegal ou um descritor já passado para uma invocação anterior de fclose().

VALOR DE RETORNO¶

Em caso de sucesso, devolve 0. Caso contrário, EOF é retornado e a variável global errno é selecionada para indicar o erro. Em ambos os casos qualquer acesso adicional (incluindo outra chamada a fclose()) para o fluxo resulta em comportamento indefinido.

ERROS¶

EBADF

O descritor do arquivo de stream não é válido.

A função fclose() pode também falhar e ajustar errno para quaisquer dos erros especificados para as rotinas close(2), write(2) ou fflush(3).

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

PADRÕES¶

C11, POSIX.1-2008.

HISTÓRICO¶

C89, POSIX.1-2001.

NOTAS¶

Note que fclose apenas descarrega os buffers de espaço do usuário fornecidos pela biblioteca do C. Para garantir que os dados estão fisicamente armazenados no disco, os buffers do kernel devem ser descarregados também, por exemplo, com sync(2) ou fsync(2).

VEJA TAMBÉM¶

close(2), fcloseall(3), fflush(3), fileno(3), fopen(3), setbuf(3)

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.