Partager via


remove, _wremove

Supprimer un fichier.

int remove(
   const char *path 
);
int _wremove(
   const wchar_t *path 
);

Paramètres

  • path
    chemin d'accès du fichier à supprimer.

Valeur de retour

Chacune de ces fonctions retourne 0 si le fichier a été supprimé avec succès.Sinon, il retourne -1 et définit errno soit sur EACCES pour indiquer que le chemin d'accès spécifie un fichier en lecture seule ou le fichier est ouvert, ou à ENOENT pour indiquer que le nom et le chemin d'accès du fichier est introuvable ou que le chemin d'accès spécifie un répertoire.

Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ce point et d'autres codes de retour.

Notes

la fonction de supprimez supprime le fichier spécifié par le chemin d'accès. _wremove est une version à caractère élargi de _remove; l'argument de chemin d'accès à**_wremove** est une chaîne à caractères larges._wremove et _remove se comportent de sinon.Tous les handles dans un fichier doivent être fermés pouvoir être supprimé.

mappages de routines de texte générique

routine de TCHAR.H

_MBCS & de _UNICODE non défini

_MBCS défini

_UNICODE défini

_tremove

remove

remove

_wremove

Configuration requise

routine

en-tête requis

remove

<stdio.h> ou <io.h>

_wremove

<stdio.h> ou <wchar.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

bibliothèques

toutes les versions de Bibliothèques runtime C.

Exemple

// crt_remove.c
/* This program uses remove to delete crt_remove.txt */

#include <stdio.h>

int main( void )
{
   if( remove( "crt_remove.txt" ) == -1 )
      perror( "Could not delete 'CRT_REMOVE.TXT'" );
   else
      printf( "Deleted 'CRT_REMOVE.TXT'\n" );
}

entrée : crt_remove.txt

This file will be deleted.

Résultat de l'exemple

Deleted 'CRT_REMOVE.TXT'

Équivalent .NET Framework

System : : E/S : : fichier : : suppression

Voir aussi

Référence

Gestion de fichiers

_unlink, _wunlink