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