_rmdir, _wrmdir
Deletes a directory.
int _rmdir( const char *dirname ); int _wrmdir( const wchar_t *dirname );
Parameters
- dirname
-
Path of the directory to be removed.
Each of these functions returns 0 if the directory is successfully deleted. A return value of –1 indicates an error and errno is set to one of the following values:
- ENOTEMPTY
-
Given path is not a directory, the directory is not empty, or the directory is either the current working directory or the root directory.
- ENOENT
-
Path is invalid.
- EACCES
-
A program has an open handle to the directory.
For more information about these and other return codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.
The _rmdir function deletes the directory specified by dirname. The directory must be empty, and it must not be the current working directory or the root directory.
_wrmdir is a wide-character version of _rmdir; the dirname argument to _wrmdir is a wide-character string. _wrmdir and _rmdir behave identically otherwise.
| Tchar.h routine | _UNICODE and _MBCS not defined | _MBCS defined | _UNICODE defined |
|---|---|---|---|
| _trmdir | _rmdir | _rmdir | _wrmdir |
| Routine | Required header | Compatibility |
|---|---|---|
| _rmdir | <direct.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _wrmdir | <direct.h> or <wchar.h> | Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
For more compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
