_rmdir, _wrmdir
Elimina una directory.
Sintassi
int _rmdir(
const char *dirname
);
int _wrmdir(
const wchar_t *dirname
);
Parametri
dirname
Percorso della directory da rimuovere.
Valore restituito
Ognuna di queste funzioni restituisce 0 se la directory viene eliminata correttamente. Il valore restituito -1 indica un errore e errno viene impostato su uno dei valori seguenti:
Valore errno |
Condizione |
|---|---|
ENOTEMPTY |
Il percorso specificato non è una directory, la directory non è vuota o la directory è la directory di lavoro corrente o la directory radice. |
ENOENT |
Il percorso non è valido. |
EACCES |
Un programma ha un handle aperto per la directory. |
Per altre informazioni su questi e altri codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.
Osservazioni:
La funzione _rmdir elimina la directory specificata da dirname. La directory deve essere vuota e non deve essere la directory di lavoro corrente o la directory radice.
_wrmdir è una versione a caratteri wide di _rmdir; l'argomento dirname in _wrmdir è una stringa di caratteri wide. In caso contrario,_wrmdir e _rmdir si comportano in modo identico.
Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.
Mapping di routine di testo generico
| Routine Tchar.h | _UNICODE e _MBCS non definito |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_trmdir |
_rmdir |
_rmdir |
_wrmdir |
Requisiti
| Ciclo | Intestazione obbligatoria |
|---|---|
_rmdir |
<direct.h> |
_wrmdir |
<direct.h> o <wchar.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Librerie
Tutte le versioni delle librerie di runtime C.
Esempio
Vedere l'esempio per _mkdir.