CKTIS / C
remove — remover um ficheiro
A função remove de <stdio.h> remove o acesso a um ficheiro com o nome indicado. Devolve zero em caso de sucesso e um valor diferente de zero em caso de erro.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <stdio.h>
int remove(const char *filename);Se a chamada a remove(filename) for bem-sucedida, o ficheiro deixa de estar acessível com o nome indicado pela cadeia filename. Ainda assim, é possível abrir mais tarde um ficheiro com esse nome, por exemplo se outro ficheiro existente tiver recebido o nome que ficou livre.
Verifique o resultado comparando-o com 0; não presuma que um erro significa especificamente -1. O comportamento para um ficheiro aberto é definido pela implementação, por isso feche o fluxo antes de o remover.
O exemplo cria um ficheiro vazio com "wx", fecha-o e remove-o. Execute-o num diretório de teste isolado.
Exemplos
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *name = "cktis-remove-demo.tmp";
FILE *file = fopen(name, "wx");
if (file == NULL) {
fputs("create failed\n", stderr);
return EXIT_FAILURE;
}
if (fclose(file) != 0) {
fputs("close failed\n", stderr);
return EXIT_FAILURE;
}
if (remove(name) != 0) {
fputs("remove failed\n", stderr);
return EXIT_FAILURE;
}
puts("removed");
return EXIT_SUCCESS;
}Resultado
removed
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.