Partager via


_rmdir, _wrmdir

Supprime un répertoire.

Syntaxe

int _rmdir(
   const char *dirname
);
int _wrmdir(
   const wchar_t *dirname
);

Paramètres

dirname
Chemin du répertoire à supprimer.

Valeur retournée

Chacune de ces fonctions retourne 0 si le répertoire est bien supprimé. Une valeur de retour de -1 indique une erreur et errno est définie sur l’une des valeurs suivantes :

Valeur errno Condition
ENOTEMPTY Le chemin d’accès n’est pas un répertoire, le répertoire n’est pas vide ou le répertoire est le répertoire de travail actif ou le répertoire racine.
ENOENT Le chemin n’est pas valide.
EACCES Un programme a un descripteur ouvert désignant le répertoire.

Pour plus d’informations sur ces codes de retour et d’autres codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La fonction _rmdir supprime le répertoire spécifié par dirname. Le répertoire doit être vide et ne doit pas être le répertoire de travail actif ou le répertoire racine.

_wrmdir est une version à caractères larges de _rmdir; l'argument dirname de _wrmdir est une chaîne à caractères larges. Sinon,_wrmdir et _rmdir se comportent de la même façon.

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 routines de texte générique

Routine Tchar.h _UNICODE et _MBCS non définis _MBCS défini _UNICODE défini
_trmdir _rmdir _rmdir _wrmdir

Spécifications

Routine En-tête requis
_rmdir <direct.h>
_wrmdir <direct.h> ou <wchar.h>

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

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

Consultez l’exemple pour _mkdir.

Voir aussi

Contrôle d’annuaire
_chdir, _wchdir
_mkdir, _wmkdir