_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 errnoEACCESsur , 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_doserrnoet _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

Gestion des fichiers
_close
remove, _wremove