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

Routine Tchar.h	_UNICODE et _MBCS non défini	_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