fclose, _fcloseall

Artigo
06/09/2015

Fecha um fluxo (ou fluxos)fclosefecha todas abertos_fcloseall().

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

Parâmetros

stream
Ponteiro a estrutura de FILE .

Valor de retorno

fclose retornará 0 se o fluxo é desligado com êxito. _fcloseall retorna o número total de fluxos fechados. Ambas as funções EOF de retorno para indicar um erro.

Comentários

A função de fclose fecha stream. Se stream é NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução for permitida continuar, fclose define errno a EINVAL e retorna EOF. É recomendado que o ponteiro de stream está sempre verificada antes de chamar essa função.

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

A função de _fcloseall fluxos fecha todas abertos exceto stdin, stdout, stderr (e, no MS-DOS, em _stdaux e em _stdprn). Fecha e também exclui todos os arquivos temporários criados por tmpfile. Em ambas as funções, todos armazena em buffer associado com o fluxo é liberado antes de fechar. Os buffers alocados pelo sistema são liberados quando o fluxo é fechado. Os buffers alocados pelo usuário com setbuf e setvbuf não são liberados automaticamente.

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

fclose e _fcloseall incluem o código para proteger contra interferência de outros threads. Para a versão sem-bloqueio de fclose, consulte _fclose_nolock.