fclose, _fcloseall

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

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

Parâmetros

  • stream
    Ponteiro para FILE estrutura.

Valor de retorno

fcloseRetorna 0 se o fluxo está fechado com êxito._fcloseallRetorna o número total de fluxos fechado.Ambas as funções retornam EOF para indicar um erro.

Comentários

O fclose função fecha stream.Se stream é NULL, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro.Se execução tiver permissão para continuar, fclose define errno para EINVAL e retorna EOF.É recomendável que o stream ponteiro sempre verificados antes para chamar essa função.

Consulte _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esses e outros códigos de erro.

The _fcloseall function closes all open streams except stdin, stdout, stderr (and, in MS-DOS, _stdaux and _stdprn).Também fecha e exclui quaisquer arquivos temporários criados por tmpfile.Em ambas as funções, associados com o fluxo de todos os buffers são liberados antes para fechamento.Buffers alocada pelo sistema são liberados quando o fluxo está fechado.Buffers atribuídos pelo usuário com setbuf e setvbuf não são automaticamente liberados.

Observação: quando essas funções são usadas para fechar um fluxo, a base descritor de arquivo e OS identificador de arquivo (ou soquete) é fechado, bem como o fluxo.Portanto, se o arquivo foi aberto originalmente como um arquivo manipular ou descritor de arquivo e fechado com fclose, também não fazer chamada _close para fechar o descritor de arquivo; Não chame a função Win32 CloseHandle para fechar o identificador de arquivo.

fclosee _fcloseall incluir código para proteger contra interferência de outros threads.Versão não-bloqueio de um fclose, consulte _fclose_nolock.

Requisitos

Função

Cabeçalho necessário

fclose

<stdio.h>

_fcloseall

<stdio.h>

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Exemplo

Consulte o exemplo para fopen.

Equivalência do .NET Framework

Consulte também

Referência

Fluxo de i/O

Close

_fdopen, _wfdopen

fflush

fopen, _wfopen

freopen, _wfreopen