remove, _wremove

Supprimer un fichier.

Syntaxe

int remove(
   const char *path
);
int _wremove(
   const wchar_t *path
);

Paramètres

path
Chemin du fichier à supprimer.

Valeur retournée

Chacune de ces fonctions retourne 0 si le fichier est bien supprimé. Sinon, elle retourne -1 et définit errno soit pour EACCES indiquer que le chemin d’accès spécifie un fichier en lecture seule, spécifie un répertoire, ou le fichier est ouvert, ou pour ENOENT indiquer que le nom de fichier ou le chemin d’accès n’a pas été trouvé.

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La remove fonction supprime le fichier spécifié parpath ._wremove est une version à caractères larges de _remove; l’argument dont il path s’agit d’une chaîne à _wremove caractères larges. Sinon,_wremove et _remove se comportent de la même façon. Tous les descripteurs d’un fichier doivent être fermés avant de pouvoir être supprimés.

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

TCHAR.H Routine	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tremove	remove	remove	_wremove

Spécifications

Routine	En-tête requis
remove	<stdio.h> ou <io.h>
_wremove	<stdio.h> ou <wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

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.

Exemple de sortie

Deleted 'CRT_REMOVE.TXT'

Voir aussi

Gestion des fichiers
_unlink, _wunlink