_unlink, _wunlink

Article
03/26/2013

Supprimer un fichier.

int _unlink(
   const char *filename 
);
int _wunlink(
   const wchar_t *filename 
);

Paramètres

filename
nom du fichier à supprimer.

Valeur de retour

Chacune de ces fonctions retourne 0 si réussie.Sinon, la fonction retourne la valeur - 1 et définit errno à EACCES, ce qui signifie que le chemin d'accès spécifie un fichier en lecture seule, ou à ENOENT, ce qui signifie que le fichier ou le chemin d'accès est introuvable ou le chemin d'accès spécifié un répertoire.

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

Notes

la fonction d' _unlink supprime le fichier spécifié par filename._wunlink est une version à caractère élargi d' _unlink; l'argument d' filename à _wunlink est une chaîne à caractères larges.Ces fonctions se comportent de sinon.

mappages de routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_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 des informations de compatibilité supplémentaires, 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" );
}