Namespaces
Variants

remove

From cppreference.net
< c ‎ | io
Défini dans l'en-tête <stdio.h>
int remove ( const char * pathname ) ;

Supprime le fichier identifié par la chaîne de caractères pointée par pathname .

Si le fichier est actuellement ouvert par un processus, le comportement de cette fonction est défini par l'implémentation. Les systèmes POSIX suppriment le nom du fichier (entrée de répertoire), mais l'espace du système de fichiers utilisé par le fichier n'est pas récupéré tant qu'il est ouvert dans un processus et que d'autres liens physiques vers le fichier existent. Windows ne permet pas la suppression du fichier dans de tels cas.

Table des matières

Paramètres

pathname - pointeur vers une chaîne terminée par un caractère nul contenant le chemin identifiant le fichier à supprimer

Valeur de retour

0 en cas de succès ou une valeur non nulle en cas d'erreur.

Notes

POSIX spécifie de nombreux détails supplémentaires concernant le comportement de cette fonction.

Exemple

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* fp = fopen("file1.txt", "w"); // create file
    if (!fp)
    {
        perror("file1.txt");
        return EXIT_FAILURE;
    }
    puts("Created file1.txt");
    fclose(fp);
    int rc = remove("file1.txt");
    if (rc)
    {
        perror("remove");
        return EXIT_FAILURE;
    }
    puts("Removed file1.txt");
    fp = fopen("file1.txt", "r"); // Failure: file does not exist
    if (!fp)
        perror("Opening removed file failed");
    rc = remove("file1.txt"); // Failure: file does not exist
    if (rc)
        perror("Double-remove failed");
    return EXIT_SUCCESS;
}

Sortie possible :

Created file1.txt
Removed file1.txt
Opening removed file failed: No such file or directory
Double-remove failed: No such file or directory

Références

  • Norme C23 (ISO/CEI 9899:2024) :
  • 7.21.4.1 La fonction remove (p: TBD)
  • Norme C17 (ISO/CEI 9899:2018) :
  • 7.21.4.1 La fonction remove (p: TBD)
  • Norme C11 (ISO/IEC 9899:2011):
  • 7.21.4.1 La fonction remove (p: 302)
  • Norme C99 (ISO/IEC 9899:1999) :
  • 7.19.4.1 La fonction remove (p: 268)
  • Norme C89/C90 (ISO/CEI 9899:1990) :
  • 4.9.4.1 La fonction remove

Voir aussi

renomme un fichier
(fonction)