_unlink
, _wunlink
Supprimer un fichier.
Syntaxe
int _unlink(
const char *filename
);
int _wunlink(
const wchar_t *filename
);
Paramètres
filename
Nom du fichier à supprimer.
Valeur retournée
Chacune de ces fonctions retourne 0 en cas d’échec. Sinon, la fonction retourne -1 et définit errno
EACCES
sur , ce qui signifie que le chemin spécifie un fichier en lecture seule ou un répertoire, ou à ENOENT
, ce qui signifie que le fichier ou le chemin d’accès n’est pas trouvé.
Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist
_doserrno
et _sys_nerr
.errno
Notes
La fonction _unlink
supprime le fichier spécifié par filename
. _wunlink
est une version à caractères larges de _unlink
; l'argument filename
de _wunlink
est une chaîne à caractères larges. Ces fonctions se comportent sinon de façon identique.
Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.
Mappages de routine de texte générique
Routine TCHAR.H | _UNICODE et _MBCS non défini |
_MBCS Défini |
_UNICODE Défini |
---|---|---|---|
_tunlink |
_unlink |
_unlink |
_wunlink |
Spécifications
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 Compatibility.
Exemple de code
Ce programme utilise _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.
Exemple de sortie
Deleted 'CRT_UNLINK.TXT'
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour