fclose, _fcloseall

Fecha um fluxo (fclose) ou fecha todos os fluxos abertos (_fcloseall).

Sintaxe

int fclose(
   FILE *stream
);
int _fcloseall( void );

Parâmetros

stream
Ponteiro para a estrutura FILE.

Retornar valor

fclose retorna 0 se o fluxo for fechado com êxito. _fcloseall retorna o número total de fluxos fechados. Ambas as funções retornam EOF para indicar um erro.

Comentários

A função fclose fecha stream. Se stream for NULL, o manipulador de parâmetros inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, fclose definirá errno para EINVAL e retornará EOF. É recomendável que você sempre verifique o stream ponteiro antes de chamar essa função.

Para obter mais informações sobre códigos de retorno, confira errno, _doserrno, _sys_errlist e _sys_nerr.

A função _fcloseall fecha todos os fluxos exceto stdin, stdout, stderr (e, no MS-DOS, _stdaux e _stdprn). Ela também fecha e exclui todos os arquivos temporários criados por tmpfile. Em ambas as funções, todos os buffers associados com o fluxo são liberados antes do fechamento. Buffers alocados pelo sistema são liberados quando o fluxo está fechado. Buffers atribuídos pelo usuário com setbuf e setvbuf não são liberados automaticamente.

Observação

Quando fclose ou funções são usadas para fechar um fluxo, o descritor de arquivo subjacente e o identificador de arquivo do sistema operacional (ou _fcloseall soquete) também são fechados. Assim, se o arquivo foi originalmente aberto como um identificador de arquivo ou descritor de arquivo e é fechado com fclose, não chame também para fechar o descritor de arquivo e não chame _close a função CloseHandle Win32 para fechar o identificador de arquivo.

fclose e _fcloseall incluem o código para proteção contra interferência de outros threads. Para uma versão sem bloqueio de um fclose, consulte _fclose_nolock.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Função	Cabeçalho necessário
fclose	<stdio.h>
_fcloseall	<stdio.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Confira o exemplo de fopen.

Confira também

E/S de fluxo
_close
_fdopen, _wfdopen
fflush
fopen, _wfopen
freopen, _wfreopen