Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

remove — supprimer un fichier

La fonction remove de <stdio.h> supprime l’accès à un fichier sous le nom indiqué. Elle renvoie zéro en cas de réussite et une valeur non nulle en cas d’échec.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdio.h>
int remove(const char *filename);

Après un appel réussi à remove(filename), le fichier n’est plus accessible sous le nom fourni par la chaîne filename. Il reste possible d’ouvrir ultérieurement un fichier sous ce nom, par exemple si un autre fichier existant a été renommé pour prendre le nom ainsi libéré.

Vérifiez le résultat en le comparant à 0 ; ne supposez pas qu’un échec signifie précisément -1. Le comportement pour un fichier ouvert dépend de l’implémentation : fermez donc le flux avant la suppression.

L’exemple crée un fichier vide avec "wx", le ferme, puis le supprime. Exécutez-le dans un répertoire de test isolé.

Exemples

#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;
}

Résultat

removed

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources