_unlink, _wunlink
Supprimer un fichier.
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Paramètres
- filename
Nom du fichier à enlever.
Valeur de retour
Chacune de ces fonctions retourne 0 en cas de succès. Sinon, la fonction retourne – 1 et affecte errno à EACCES, ce qui signifie que le chemin d'accès indique un fichier en lecture seule, ou à ENOENT, c'est-à-dire que le fichier ou le chemin d'accès est introuvable ou que le chemin d'accès spécifié 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 _unlink supprime le fichier spécifié par filename. _wunlink est une version à caractères larges de _unlink; l'argument filename vers _wunlink est une chaîne à caractères larges. Ces fonctions se comportent sinon de façon identique.
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE & _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Configuration requise
Routine |
En-tête requis |
---|---|
_unlink |
<io.h> et <stdio.h> |
_wunlink |
<io.h> ou <wchar.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.
Exemple de code
Ce programme utilise le _unlink pour supprimer CRT_UNLINK.TXT.
// crt_unlink.c
#include <stdio.h>
int main( void )
{
if( _unlink( "crt_unlink.txt" ) == -1 )
perror( "Could not delete 'CRT_UNLINK.TXT'" );
else
printf( "Deleted 'CRT_UNLINK.TXT'\n" );
}
Entrée : crt_unlink.txt
This file will be deleted.
Résultat de l'exemple
Deleted 'CRT_UNLINK.TXT'