fclose(3)

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).
Interface | Atributo | Valor
fclose() | Thread safety | MT-Safe

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-portuguese@lists.debian.org).