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.