CKTIS / C
freopen — função de fluxo C23
`freopen(filename, mode, stream)` de `<stdio.h>` fecha o ficheiro associado e reassocia o mesmo objeto `FILE` ao ficheiro e modo indicados. Devolve `stream` no sucesso ou null na falha.
Versão: C23
Sintaxe
FILE *freopen(const char * restrict filename, const char * restrict mode, FILE * restrict stream);freopen(filename, mode, stream) de <stdio.h> fecha o ficheiro associado e reassocia o mesmo objeto FILE ao ficheiro e modo indicados. Devolve stream no sucesso ou null na falha.
O exemplo cria ficheiro nomeado, escreve 42, chama freopen(name, "r", stream) e lê o valor. 1 42 mostra reabertura bem-sucedida do mesmo fluxo noutro modo.
Erros ao fechar o ficheiro antigo são ignorados; após falha de freopen, o fluxo original fica fechado e não pode ser usado. Com filename == NULL, tenta mudar o modo do ficheiro cujo nome já está associado ao fluxo; a implementação define mudanças permitidas e circunstâncias. Testa o retorno; w pode truncar e a anexa.
Exemplos
#include <stdio.h>
int main(void){const char *name="c_ref_21_freopen.tmp";FILE *stream=fopen(name,"w");if(!stream)return 1;if(fputs("42",stream)==EOF){fclose(stream);remove(name);return 1;}stream=freopen(name,"r",stream);if(!stream){remove(name);return 1;}int value=0,ok=fscanf(stream,"%d",&value)==1;int closed=fclose(stream),removed=remove(name);printf("%d %d\n",ok,value);return closed==0&&removed==0?0:1;}
Resultado
1 42
O exemplo cria ficheiro nomeado, escreve `42`, chama `freopen(name, "r", stream)` e lê o valor. `1 42` mostra reabertura bem-sucedida do mesmo fluxo noutro modo.