Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes