Bagikan melalui

_rmdir, _wrmdir

  • Artikel

Menghapus direktori.

Sintaks

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

Parameter

dirname
Jalur direktori yang akan dihapus.

Nilai hasil

Masing-masing fungsi ini mengembalikan 0 jika direktori berhasil dihapus. Nilai pengembalian -1 menunjukkan kesalahan dan errno diatur ke salah satu nilai berikut:

errno nilai Kondisi
ENOTEMPTY Jalur yang diberikan bukan direktori, direktori tidak kosong, atau direktori adalah direktori kerja saat ini atau direktori akar.
ENOENT Jalur tidak valid.
EACCES Program memiliki handel terbuka ke direktori.

Untuk informasi selengkapnya tentang kode pengembalian ini dan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Fungsi _rmdir menghapus direktori yang ditentukan oleh dirname. Direktori harus kosong, dan tidak boleh menjadi direktori kerja saat ini atau direktori akar.

_wrmdir adalah versi karakter luas dari _rmdir; dirname argumen ke _wrmdir adalah string karakter lebar. _wrmdir dan _rmdir berulah secara identik jika tidak.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Rutinitas Tchar.h _UNICODE dan _MBCS tidak ditentukan _MBCS Didefinisikan _UNICODE Didefinisikan
_trmdir _rmdir _rmdir _wrmdir

Persyaratan

Rutin Header yang diperlukan
_rmdir <direct.h>
_wrmdir <direct.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Contoh

Lihat contoh untuk _mkdir.

Lihat juga

Kontrol direktori
_chdir, _wchdir
_mkdir, _wmkdir