_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.