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 à changer.
Valeur de retour
Chacune de ces fonctions retourne 0 si le fichier a été supprimé avec succès. Sinon, retourne -1 et affecte errno soit à EACCES pour indiquer que le chemin d'accès indique un fichier en lecture seule ou le fichier est ouvert, soit à ENOENT pour indiquer que le nom de fichier et le chemin d'accès 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 ces éléments et autres codes de retour.
Notes
La fonction supprimer supprime le fichier spécifié par le chemin d'accès. _wremove est une version de caractères larges de _remove; l'argument path à _wremove est une chaîne de caractères larges. Sinon, _wremove et se comportent de la même façon. Tous les descripteurs d'un fichier doivent être fermés avant de pouvoir le supprimer.
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE & _MBCS non définis |
_MBCS défini |
_UNICODE défini |
|---|---|---|---|
_tremove |
remove |
remove |
_wremove |
Configuration requise
Routine |
En-tête requis |
|---|---|
remove |
<stdio.h> ou <wchar.h> |
_wremove |
<stdio.h> ou <wchar.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.
Bibliothèques
Toutes les versions des 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'